API

Public API for QA test management

Call /api/v1 with a bearer token so agents and automation actors can manage test cases, runs, executions and defects. OpenAPI 3.1 contract for agent-led QA.

Base path

All versioned routes live under /api/v1/workspaces/{workspaceId}/…. The OpenAPI document is published at /api/v1/openapi.json.

OpenAPI documenthttps://www.tiora.cz/api/v1/openapi.json

Authentication

Send Authorization: Bearer <token>. Tokens come from Connector OAuth (interactive hosts) or an Automation Access Token (CI / automation actor). Coarse scopes are read and write, bound to one workspace. Workspace roles still apply.

Resource groups

Workspace search, projects, members and statuses. Project folders, labels, environments, build versions, test cases, run recipes, test runs, executions (claim, progress, outcome), defects and failure screenshots.

Not included

The API does not ingest Playwright, Cypress or CI result files. Agents and automation actors use claim and record flows to store outcomes from checks they ran with their own tools.