REST API reference

The REST API is generated from the Tiden gRPC API through grpc-gateway. Public automation should use API tokens and the endpoints listed as public.

Base URL

https://app.tiden.ai

Authentication header

Authorization: Bearer <token>

Public API endpoints

These endpoints are intended for API tokens, CLI, MCP, CI, and customer automation.

Auth, workspace, and product

Method	Path	Purpose
GET	/v1/auth/me	Current user for the token
PUT	/v1/auth/onboarding	Update onboarding state
GET	/v1/workspaces	List workspaces
POST	/v1/workspaces/{workspace_id}/products	Create product
GET	/v1/workspaces/{workspace_id}/products	List products
POST	/v1/products/{product_id}/setup:verify	Verify product setup state

Requirements

Method	Path	Purpose
POST	/v1/products/{product_id}/requirements	Create requirement
GET	/v1/products/{product_id}/requirements	List requirements
GET	/v1/requirements/{id}	Get requirement
PUT	/v1/requirements/{id}	Update requirement
DELETE	/v1/requirements/{id}	Delete requirement

Tests

Method	Path	Purpose
POST	/v1/products/{product_id}/tests	Create suite or case
PUT	/v1/tests/{id}	Update test
GET	/v1/products/{product_id}/tests	List tests
GET	/v1/tests/{id}	Get test
DELETE	/v1/tests/{id}	Delete test
POST	/v1/tests/{test_id}/links	Link test to requirement or propose branch link
DELETE	/v1/tests/{test_id}/links/{requirement_id}	Unlink test and requirement
GET	/v1/tests/{test_id}/links	List test links
GET	/v1/branches/{branch_id}/link-proposals	List branch link proposals
POST	/v1/branches/{branch_id}/link-proposals:review	Review branch link proposals
POST	/v1/products/{product_id}/tests:ingest	Ingest reporter draft

Branches and components

Method	Path	Purpose
POST	/v1/products/{product_id}/branches	Create branch
GET	/v1/products/{product_id}/branches	List branches
GET	/v1/branches/{id}	Get branch
DELETE	/v1/branches/{id}	Delete branch
GET	/v1/branches/{id}/merge-preview	Preview merge
POST	/v1/branches/{id}/merge	Merge branch
POST	/v1/products/{product_id}/components	Create component
GET	/v1/products/{product_id}/components	List components

Environments and releases

Method	Path	Purpose
POST	/v1/products/{product_id}/environments	Create environment
GET	/v1/products/{product_id}/environments	List environments
GET	/v1/environments/{id}	Get environment
DELETE	/v1/environments/{id}	Delete environment
POST	/v1/products/{product_id}/releases	Create or update release
GET	/v1/products/{product_id}/releases	List releases
GET	/v1/releases/{id}	Get release

Quality gates

Method	Path	Purpose
POST	/v1/products/{product_id}/quality-gate:compute	Compute verdict
GET	/v1/products/{product_id}/quality-gate	Get latest verdict
GET	/v1/products/{product_id}/quality-gate/traceability	Get traceability matrix
POST	/v1/products/{product_id}/quality-gate:accept-risk	Accept risk
POST	/v1/products/{product_id}/quality-gate:approve-risk	Approve risk

Agents

Method	Path	Purpose
GET	/v1/agent-types	List agent types
GET	/v1/products/{product_id}/agent-configs	List agent configs
GET	/v1/agent-configs/{id}	Get agent config
POST	/v1/products/{product_id}/agent-configs	Create agent config
DELETE	/v1/agent-configs/{id}	Delete agent config
POST	/v1/agent-configs/{agent_config_id}/runs	Start agent run
POST	/v1/agent-runs/{id}:cancel	Cancel agent run
GET	/v1/agent-runs/{id}	Get agent run
GET	/v1/agent-configs/{agent_config_id}/runs	List runs
GET	/v1/agent-runs/{run_id}/events	List run events
GET	/v1/agent-runs/{run_id}/events:stream	Stream run events

Agent retrieval and intent

Method	Path	Purpose
GET	/v1/products/{product_id}/coverage-gaps	Get coverage gaps
GET	/v1/products/{product_id}/requirements/{requirement_id}/test-context	Get test generation context
POST	/v1/products/{product_id}/test-generation-context:prepare	Prepare test generation context
POST	/v1/products/{product_id}/intent:distill	Distill intent into branch

Issues

Error tracking reads and status changes are available to API tokens, so the CLI, the MCP server, CI, and coding agents can triage issues without a browser session.

Method	Path	Purpose
GET	/v1/products/{product_id}/issues	List issues, newest activity first
GET	/v1/issues/{id}	Get an issue with its latest occurrence
GET	/v1/issues/{id}/events	List an issue's occurrences
GET	/v1/issues/{id}/events/{event_id}	Get one occurrence with symbolicated frames
GET	/v1/issues/{id}/stats	Occurrence counts over time and per environment
GET	/v1/releases/{release_id}/issues	Issues first seen in a release
POST	/v1/issues/{id}:setStatus	Set one issue's status
POST	/v1/products/{product_id}/issues:bulkSetStatus	Set the same status on many issues
GET	/v1/products/{product_id}/issues/{issue_id}/fix-context	Everything needed to fix one issue, in one call

Notes:

• GET /v1/products/{product_id}/issues filters on status (unresolved, resolved, ignored, or empty for all), environment_id, release_id, component_id, repeated levels and platforms, and a trailing period window (3m, 1h, 12h, 1d, 7d, 30d). Sort with sort (last_seen, first_seen, times_seen) and page with the opaque cursor in pagination.page_token.
• An issue itself has no environment — environment lives on its occurrences. Use GET /v1/issues/{id}/stats to learn where an issue is actually happening.
• GET /v1/issues/{id} symbolicates only the latest occurrence. When the occurrence that matters is not the latest one, fetch it directly with GET /v1/issues/{id}/events/{event_id}.
• event_id in the occurrence path is the occurrence's Tiden id, not the event_id the SDK generated.
• Status changes are recorded with the actor that made them and are reversible.
• fix-context returns the issue, its symbolicated frames, the repository files those frames implicate, the per-environment split, the attributed component, and — for each requirement those files implement — whether a test already covers it (verified, not_run, or no_test). It accepts branch and max_frames, clears the raw event payload, and names anything it dropped in truncation_signals. Prefer it over stitching the reads above together.

Source map upload

Method	Path	Purpose
POST	/v1/products/{product_id}/sourcemaps	Create source map upload
POST	/v1/sourcemaps/{id}:confirm	Confirm source map upload

Web-only endpoint groups

These are primarily for the Tiden web app and browser sessions:

• Signup, login, refresh, logout, profile, password, avatar, MFA, and passkeys.
• API token create/list/revoke.
• Organization members, invites, roles, statuses, workspace scopes, and invite links.
• Workspace create/update/delete, members, invites, and invite links.
• Product get/update/delete and product setup read.
• Component get/update/delete.
• Environment update.
• Requirement/test move, history, and restore.
• Attachment upload/download.
• Credential create/list/delete/test.
• Billing overview, checkout, portal, and pricing.
• Issue DSN key management, inbound filters, the issue overview aggregates that back UI tiles (counts, stats, facets), and source map list/delete.
• Quality gate overview history and mark-seen.
• Agent config update, memory, triggers, and artifacts.

Error tracking ingest endpoint

SDK event ingest is not a proto REST endpoint. It is a separate DSN-authenticated HTTP surface:

POST /api/{product_id}/envelope/?tiden_key=<publicKey>
POST /api/{product_id}/store/?tiden_key=<publicKey>

Use Custom ingest only when an official SDK is not available.