{"openapi":"3.1.0","info":{"title":"Backlog Syntax API","version":"0.1.0","description":"Contract-first REST API for a secure, multi-tenant, agent-native backlog."},"servers":[{"url":"https://backlog-api.syntaxlab.com.br"}],"components":{"securitySchemes":{"sessionCookie":{"type":"apiKey","in":"cookie","name":"__Host-backlog_session","description":"Better Auth browser session cookie. The configured name may differ locally."},"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"PAT or OAuth 2.1 access token"}},"schemas":{"WorkspaceContext":{"type":"object","properties":{"workspace":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"name":{"type":"string","minLength":1,"maxLength":120},"slug":{"type":"string","minLength":1,"maxLength":80}},"required":["id","name","slug"],"additionalProperties":false},"principal":{"type":"object","properties":{"subjectType":{"type":"string","enum":["user","service_account"]},"subjectId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"role":{"type":"string","enum":["owner","admin","member","viewer"]}},"required":["subjectType","subjectId","role"],"additionalProperties":false},"projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"name":{"type":"string","minLength":1,"maxLength":120},"slug":{"type":"string","minLength":1,"maxLength":80},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"}},"required":["id","name","slug","updatedAt"],"additionalProperties":false}}},"required":["workspace","principal","projects"],"additionalProperties":false},"ProblemDetail":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string","minLength":1},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string","minLength":1},"instance":{"type":"string","minLength":1},"traceId":{"type":"string","minLength":1},"code":{"type":"string","enum":["invalid_request","unauthenticated","forbidden","not_found","conflict","stale_version","rate_limited","payload_too_large","internal_error","dependency_unavailable","reauthentication_required","sole_owner_workspace","invalid_confirmation"]},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1},"message":{"type":"string","minLength":1}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","traceId","code"],"additionalProperties":false},"AccountExport":{"type":"object","properties":{"exportedAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"account":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"name":{"type":"string"},"email":{"type":"string","format":"email"},"emailVerified":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"termsAcceptedAt":{"type":"string","nullable":true,"format":"date-time","example":"2026-08-31T12:00:00Z"},"privacyNoticeAcceptedAt":{"type":"string","nullable":true,"format":"date-time","example":"2026-08-31T12:00:00Z"},"legalNoticeVersion":{"type":"string","nullable":true}},"required":["id","name","email","emailVerified","createdAt","updatedAt","termsAcceptedAt","privacyNoticeAcceptedAt","legalNoticeVersion"],"additionalProperties":false},"sessions":{"type":"array","items":{"type":"object","properties":{"createdAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"expiresAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"ipAddress":{"type":"string","nullable":true},"userAgent":{"type":"string","nullable":true}},"required":["createdAt","updatedAt","expiresAt","ipAddress","userAgent"],"additionalProperties":false}},"memberships":{"type":"array","items":{"type":"object","properties":{"workspaceId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"workspaceName":{"type":"string"},"workspaceSlug":{"type":"string","maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"role":{"type":"string","enum":["owner","admin","member","viewer"]}},"required":["workspaceId","workspaceName","workspaceSlug","role"],"additionalProperties":false}}},"required":["exportedAt","account","sessions","memberships"],"additionalProperties":false},"AccountDeletionReceipt":{"type":"object","properties":{"receiptId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"deletedAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"membershipsRemoved":{"type":"integer","minimum":0}},"required":["receiptId","deletedAt","membershipsRemoved"],"additionalProperties":false},"DeleteAccountInput":{"type":"object","properties":{"confirmation":{"type":"string","enum":["excluir"]},"email":{"type":"string","format":"email"}},"required":["confirmation","email"],"additionalProperties":false},"WorkspaceList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Workspace"}},"page":{"$ref":"#/components/schemas/CursorPage"}},"required":["data","page"],"additionalProperties":false},"Workspace":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"name":{"type":"string","minLength":1,"maxLength":120},"slug":{"type":"string","maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"role":{"type":"string","enum":["owner","admin","member","viewer"]},"createdAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"}},"required":["id","name","slug","role","createdAt","updatedAt"],"additionalProperties":false},"CursorPage":{"type":"object","properties":{"nextCursor":{"type":"string","nullable":true,"minLength":1,"maxLength":512,"description":"Opaque pagination cursor returned by the previous response."},"hasMore":{"type":"boolean"}},"required":["nextCursor","hasMore"],"additionalProperties":false},"TaskEventList":{"type":"array","items":{"$ref":"#/components/schemas/TaskEvent"}},"TaskEvent":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"taskId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"eventType":{"type":"string","enum":["evidence","decision_request","decision","comment"]},"content":{"type":"string","minLength":1,"maxLength":20000},"actorSubjectType":{"type":"string","enum":["user","service_account"]},"actorSubjectId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"origin":{"type":"string","enum":["rest","mcp","system"]},"createdAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"}},"required":["id","taskId","eventType","content","actorSubjectType","actorSubjectId","origin","createdAt"],"additionalProperties":false},"WorkspaceExport":{"type":"object","properties":{"exportedAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"workspace":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"name":{"type":"string","minLength":1,"maxLength":120},"slug":{"type":"string","maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"createdAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"}},"required":["id","name","slug","createdAt","updatedAt"],"additionalProperties":false},"projects":{"type":"array","items":{"$ref":"#/components/schemas/Project"}},"tasks":{"type":"array","items":{"$ref":"#/components/schemas/Task"}},"taskEvents":{"type":"array","items":{"$ref":"#/components/schemas/TaskEvent"}},"serviceAccounts":{"type":"array","items":{"$ref":"#/components/schemas/ServiceAccount"}},"apiTokens":{"type":"array","items":{"$ref":"#/components/schemas/ApiToken"}}},"required":["exportedAt","workspace","projects","tasks","taskEvents","serviceAccounts","apiTokens"],"additionalProperties":false},"Project":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"workspaceId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"name":{"type":"string","minLength":1,"maxLength":120},"slug":{"type":"string","maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"description":{"type":"string","nullable":true,"maxLength":10000},"createdAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"}},"required":["id","workspaceId","name","slug","description","createdAt","updatedAt"],"additionalProperties":false},"Task":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"workspaceId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"projectId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"title":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","nullable":true,"maxLength":50000},"status":{"type":"string","enum":["open","in_progress","blocked","done"]},"priority":{"type":"string","enum":["low","medium","high","urgent"]},"blockedReason":{"type":"string","nullable":true,"maxLength":2000},"scheduledDate":{"type":"string","nullable":true,"format":"date","example":"2026-09-08"},"dueDate":{"type":"string","nullable":true,"format":"date","example":"2026-09-08"},"position":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"},"version":{"type":"integer","minimum":0,"exclusiveMinimum":true},"createdAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"archivedAt":{"type":"string","nullable":true,"format":"date-time","example":"2026-08-31T12:00:00Z"},"claimedBy":{"$ref":"#/components/schemas/ActiveTaskClaim"},"createdBy":{"$ref":"#/components/schemas/TaskAuthor"}},"required":["id","workspaceId","projectId","title","description","status","priority","blockedReason","scheduledDate","dueDate","position","version","createdAt","updatedAt","archivedAt","claimedBy","createdBy"],"additionalProperties":false},"ActiveTaskClaim":{"type":"object","nullable":true,"properties":{"subjectType":{"type":"string","enum":["user","service_account"]},"subjectId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"leaseExpiresAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"}},"required":["subjectType","subjectId","leaseExpiresAt"],"additionalProperties":false},"TaskAuthor":{"type":"object","nullable":true,"properties":{"subjectType":{"type":"string","enum":["user","service_account"]},"subjectId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"}},"required":["subjectType","subjectId"],"additionalProperties":false},"ServiceAccount":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"workspaceId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"name":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","nullable":true,"maxLength":2000},"createdAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"}},"required":["id","workspaceId","name","description","createdAt"],"additionalProperties":false},"ApiToken":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"serviceAccountId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"name":{"type":"string","minLength":1,"maxLength":120},"prefix":{"type":"string","minLength":8,"maxLength":64},"scopes":{"type":"array","items":{"type":"string","enum":["read","write"]},"minItems":1},"expiresAt":{"type":"string","nullable":true,"format":"date-time","example":"2026-08-31T12:00:00Z"},"lastUsedAt":{"type":"string","nullable":true,"format":"date-time","example":"2026-08-31T12:00:00Z"},"revokedAt":{"type":"string","nullable":true,"format":"date-time","example":"2026-08-31T12:00:00Z"},"createdAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"}},"required":["id","serviceAccountId","name","prefix","scopes","expiresAt","lastUsedAt","revokedAt","createdAt"],"additionalProperties":false},"ProjectList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Project"}},"page":{"$ref":"#/components/schemas/CursorPage"}},"required":["data","page"],"additionalProperties":false},"TaskQueue":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}},"required":["data"],"additionalProperties":false},"TaskList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Task"}},"page":{"$ref":"#/components/schemas/CursorPage"}},"required":["data","page"],"additionalProperties":false},"TaskClaim":{"type":"object","properties":{"taskId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"subjectType":{"type":"string","enum":["user","service_account"]},"subjectId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"claimedAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"heartbeatAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"},"leaseExpiresAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"}},"required":["taskId","subjectType","subjectId","claimedAt","heartbeatAt","leaseExpiresAt"],"additionalProperties":false},"ServiceAccountList":{"type":"array","items":{"$ref":"#/components/schemas/ServiceAccount"}},"ApiTokenList":{"type":"array","items":{"$ref":"#/components/schemas/ApiToken"}},"CreatedApiToken":{"type":"object","properties":{"token":{"type":"string","minLength":32},"metadata":{"$ref":"#/components/schemas/ApiToken"}},"required":["token","metadata"],"additionalProperties":false}},"parameters":{}},"paths":{"/v1/workspaces/{workspaceId}/context":{"get":{"operationId":"getWorkspaceContext","summary":"Get workspace context","description":"Returns the authenticated principal and trusted context for one accessible workspace.","tags":["Workspace context"],"security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"}],"responses":{"200":{"description":"Trusted workspace and principal context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceContext"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/account/export":{"get":{"operationId":"exportAccount","summary":"Export account data","description":"Returns a portable export of the authenticated account and its owned data.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"responses":{"200":{"description":"Authenticated account export","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountExport"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/account/delete":{"post":{"operationId":"deleteAccount","summary":"Delete the authenticated account","description":"Deletes the authenticated account after the submitted email confirms the request.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAccountInput"}}}},"responses":{"200":{"description":"Account deletion receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountDeletionReceipt"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces":{"get":{"operationId":"listWorkspaces","summary":"List accessible workspaces","description":"Returns a cursor-paginated list of workspaces accessible to the principal.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":512,"description":"Opaque pagination cursor returned by the previous response."},"required":false,"description":"Opaque pagination cursor returned by the previous response.","name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Workspaces","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceList"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}},"post":{"operationId":"createWorkspace","summary":"Create a workspace","description":"Creates a workspace owned by the authenticated principal.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"slug":{"type":"string","maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},"required":["name","slug"],"additionalProperties":false}}}},"responses":{"201":{"description":"Workspace created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Workspace"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/tasks/{taskId}/events":{"get":{"operationId":"listTaskEvents","summary":"List task events","description":"Returns the audit event history for one task in an accessible workspace.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"taskId","in":"path"}],"responses":{"200":{"description":"Task events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEventList"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}},"post":{"operationId":"recordTaskEvent","summary":"Record a task event","description":"Appends an idempotent audit event when the submitted task version is current.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"taskId","in":"path"},{"schema":{"type":"string","minLength":8,"maxLength":200},"required":true,"name":"Idempotency-Key","in":"header"},{"schema":{"type":"string","minLength":1,"maxLength":32},"required":true,"name":"If-Match","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"eventType":{"type":"string","enum":["evidence","decision_request","decision","comment"]},"content":{"type":"string","minLength":1,"maxLength":20000}},"required":["eventType","content"],"additionalProperties":false}}}},"responses":{"201":{"description":"Event recorded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEvent"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/export":{"get":{"operationId":"exportWorkspace","summary":"Export a workspace","description":"Returns a portable export of one accessible workspace and its domain data.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"}],"responses":{"200":{"description":"Workspace export","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceExport"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}":{"patch":{"operationId":"updateWorkspace","summary":"Update a workspace","description":"Updates mutable settings for one accessible workspace.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"slug":{"type":"string","maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Workspace updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Workspace"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}},"delete":{"operationId":"deleteWorkspace","summary":"Delete a workspace","description":"Permanently deletes one accessible workspace and its domain data.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"}],"responses":{"204":{"description":"Workspace deleted"},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/projects":{"get":{"operationId":"listProjects","summary":"List workspace projects","description":"Returns a filtered, cursor-paginated list of projects in one workspace.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":512,"description":"Opaque pagination cursor returned by the previous response."},"required":false,"description":"Opaque pagination cursor returned by the previous response.","name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Projects","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectList"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}},"post":{"operationId":"createProject","summary":"Create a project","description":"Creates an idempotent project in one accessible workspace.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","minLength":8,"maxLength":200},"required":true,"name":"Idempotency-Key","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"slug":{"type":"string","maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"description":{"type":"string","maxLength":10000}},"required":["name","slug"],"additionalProperties":false}}}},"responses":{"201":{"description":"Project created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Project"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/projects/{projectId}":{"get":{"operationId":"getProject","summary":"Get a project","description":"Returns one project when it belongs to the requested accessible workspace.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"projectId","in":"path"}],"responses":{"200":{"description":"Project","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Project"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}},"patch":{"operationId":"updateProject","summary":"Update a project","description":"Updates one project through an idempotent workspace-scoped request.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"projectId","in":"path"},{"schema":{"type":"string","minLength":8,"maxLength":200},"required":true,"name":"Idempotency-Key","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"slug":{"type":"string","maxLength":80,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"description":{"type":"string","maxLength":10000}},"additionalProperties":false}}}},"responses":{"200":{"description":"Project updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Project"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}},"delete":{"operationId":"deleteProject","summary":"Delete a project","description":"Deletes one project through an idempotent workspace-scoped request. Refuses with 409 while the project still holds tasks, unless withTasks is set, which deletes them with it.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"projectId","in":"path"},{"schema":{"type":"string","enum":["true","false"],"default":"false"},"required":false,"name":"withTasks","in":"query"},{"schema":{"type":"string","minLength":8,"maxLength":200},"required":true,"name":"Idempotency-Key","in":"header"}],"responses":{"204":{"description":"Project deleted"},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"Project still holds tasks and withTasks was not set","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/task-queue":{"get":{"operationId":"listTaskQueue","summary":"List the execution queue of a project","description":"Returns open, unclaimed tasks of one project as current state, for an agent that polls for work. Rate limited to one request per minute per principal.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"projectId","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Queued tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskQueue"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"429":{"description":"Rate limit exceeded; retry after the advertised delay"},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/tasks":{"get":{"operationId":"listTasks","summary":"List workspace tasks","description":"Returns a filtered, cursor-paginated list of tasks in one workspace.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","minLength":1,"maxLength":512,"description":"Opaque pagination cursor returned by the previous response."},"required":false,"description":"Opaque pagination cursor returned by the previous response.","name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":false,"name":"projectId","in":"query"},{"schema":{"type":"string","enum":["open","in_progress","blocked","done"]},"required":false,"name":"status","in":"query"}],"responses":{"200":{"description":"Tasks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskList"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}},"post":{"operationId":"createTask","summary":"Create a task","description":"Creates an idempotent task in one accessible workspace.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","minLength":8,"maxLength":200},"required":true,"name":"Idempotency-Key","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"title":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":50000},"priority":{"type":"string","enum":["low","medium","high","urgent"],"default":"medium"},"scheduledDate":{"type":"string","format":"date","example":"2026-09-08"},"dueDate":{"type":"string","format":"date","example":"2026-09-08"}},"required":["projectId","title"],"additionalProperties":false}}}},"responses":{"201":{"description":"Task created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Task"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/tasks/{taskId}":{"get":{"operationId":"getTask","summary":"Get a task","description":"Returns one task and its current version from an accessible workspace.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"taskId","in":"path"}],"responses":{"200":{"description":"Task","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Task"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}},"patch":{"operationId":"updateTask","summary":"Update a task","description":"Updates one task idempotently when the If-Match version matches current state.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"taskId","in":"path"},{"schema":{"type":"string","minLength":8,"maxLength":200},"required":true,"name":"Idempotency-Key","in":"header"},{"schema":{"type":"string","minLength":1,"maxLength":32},"required":true,"name":"If-Match","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"projectId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"title":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","nullable":true,"maxLength":50000},"status":{"type":"string","enum":["open","in_progress","blocked","done"]},"priority":{"type":"string","enum":["low","medium","high","urgent"]},"blockedReason":{"type":"string","nullable":true,"maxLength":2000},"scheduledDate":{"type":"string","nullable":true,"format":"date","example":"2026-09-08"},"dueDate":{"type":"string","nullable":true,"format":"date","example":"2026-09-08"},"position":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Task updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Task"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}},"delete":{"operationId":"deleteTask","summary":"Delete a task","description":"Deletes one task idempotently when the If-Match version matches current state.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"taskId","in":"path"},{"schema":{"type":"string","minLength":8,"maxLength":200},"required":true,"name":"Idempotency-Key","in":"header"},{"schema":{"type":"string","minLength":1,"maxLength":32},"required":true,"name":"If-Match","in":"header"}],"responses":{"204":{"description":"Task deleted"},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/tasks/{taskId}/claim":{"post":{"operationId":"claimTask","summary":"Claim a task","description":"Creates a time-limited task claim when the submitted version is current.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"taskId","in":"path"},{"schema":{"type":"string","minLength":8,"maxLength":200},"required":true,"name":"Idempotency-Key","in":"header"},{"schema":{"type":"string","minLength":1,"maxLength":32},"required":true,"name":"If-Match","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"leaseSeconds":{"type":"integer","minimum":60,"maximum":86400,"default":1800}},"additionalProperties":false}}}},"responses":{"200":{"description":"Task claimed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskClaim"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/tasks/{taskId}/claim/extend":{"post":{"operationId":"extendTaskClaim","summary":"Extend a task claim","description":"Extends an active task claim when the submitted version is current.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"taskId","in":"path"},{"schema":{"type":"string","minLength":8,"maxLength":200},"required":true,"name":"Idempotency-Key","in":"header"},{"schema":{"type":"string","minLength":1,"maxLength":32},"required":true,"name":"If-Match","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"leaseSeconds":{"type":"integer","minimum":60,"maximum":86400,"default":1800}},"additionalProperties":false}}}},"responses":{"200":{"description":"Claim extended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskClaim"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/tasks/{taskId}/claim/release":{"post":{"operationId":"releaseTaskClaim","summary":"Release a task claim","description":"Releases an active task claim when the submitted version is current.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"taskId","in":"path"},{"schema":{"type":"string","minLength":8,"maxLength":200},"required":true,"name":"Idempotency-Key","in":"header"},{"schema":{"type":"string","minLength":1,"maxLength":32},"required":true,"name":"If-Match","in":"header"}],"responses":{"204":{"description":"Claim released"},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/tasks/{taskId}/handoff":{"post":{"operationId":"handoffTask","summary":"Hand off a task","description":"Transfers an active task claim to another eligible principal.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"taskId","in":"path"},{"schema":{"type":"string","minLength":8,"maxLength":200},"required":true,"name":"Idempotency-Key","in":"header"},{"schema":{"type":"string","minLength":1,"maxLength":32},"required":true,"name":"If-Match","in":"header"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"targetSubjectType":{"type":"string","enum":["user","service_account"]},"targetSubjectId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"note":{"type":"string","minLength":1,"maxLength":4000}},"required":["targetSubjectType","targetSubjectId","note"],"additionalProperties":false}}}},"responses":{"200":{"description":"Task handed off","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskClaim"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/service-accounts":{"get":{"operationId":"listServiceAccounts","summary":"List service accounts","description":"Returns service accounts bound to one accessible workspace.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"}],"responses":{"200":{"description":"Service accounts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceAccountList"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}},"post":{"operationId":"createServiceAccount","summary":"Create a service account","description":"Creates a scoped technical principal bound to one accessible workspace.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":2000}},"required":["name"],"additionalProperties":false}}}},"responses":{"201":{"description":"Service account created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceAccount"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/service-accounts/{serviceAccountId}":{"delete":{"operationId":"revokeServiceAccount","summary":"Revoke a service account","description":"Revokes one workspace service account and all tokens issued to it.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"serviceAccountId","in":"path"}],"responses":{"204":{"description":"Service account and tokens revoked"},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/api-tokens":{"get":{"operationId":"listApiTokens","summary":"List API tokens","description":"Returns token metadata for service accounts in one accessible workspace.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"}],"responses":{"200":{"description":"API tokens","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiTokenList"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}},"post":{"operationId":"createApiToken","summary":"Create an API token","description":"Issues a scoped API token whose secret is returned only in this response.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"serviceAccountId":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"name":{"type":"string","minLength":1,"maxLength":120},"scopes":{"type":"array","items":{"type":"string","enum":["read","write"]},"minItems":1},"expiresAt":{"type":"string","format":"date-time","example":"2026-08-31T12:00:00Z"}},"required":["serviceAccountId","name","scopes"],"additionalProperties":false}}}},"responses":{"201":{"description":"API token created; secret is returned once","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedApiToken"}}}},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}},"/v1/workspaces/{workspaceId}/api-tokens/{tokenId}":{"delete":{"operationId":"revokeApiToken","summary":"Revoke an API token","description":"Revokes one API token in an accessible workspace.","security":[{"sessionCookie":[]},{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"workspaceId","in":"path"},{"schema":{"type":"string","format":"uuid","example":"019641a8-8c54-7f6c-8d2f-3fd1eb8b7531"},"required":true,"name":"tokenId","in":"path"}],"responses":{"204":{"description":"API token revoked"},"401":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"409":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"413":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"422":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"500":{"description":"RFC 9457 Problem Details","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}}}}