{"openapi":"3.1.1","info":{"title":"Team Time API","version":"1.2.0","description":"Organization or single-project operational API. Keys act as their creating admin, constrained by their immutable access target and scopes. GET /context returns access.type, access.projectId, access.projectName and available operation IDs. Project keys cannot manage shared organization/team/workflow/client settings, create projects, or review whole weeks. Out-of-target resources return 404; organization-only operations return 403. Send a UUID Idempotency-Key with every mutation; safe replay lasts seven days. Responses use explicit JSON DTOs. Due dates are calendar dates in the organization timezone. Account/ownership/key management require a signed-in session."},"servers":[{"url":"/api/v1"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Team Time API key","description":"Create a key in organization Settings → API keys. Never send it in a URL."}}},"paths":{"/coordination/runs":{"post":{"operationId":"registerAgentRun","summary":"Register a chat run","description":"Task-scoped agent coordination. Project coordination must be enabled by a human administrator. Availability is advisory; no timeout releases task ownership. Mutations require an Idempotency-Key.\nRequired application permissions: tasks:read, tasks:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["coordination"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read","tasks:write"],"x-project-access":true,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"runId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"installationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sessionId":{"type":"string","minLength":1,"maxLength":200},"provider":{"default":"codex","type":"string","const":"codex"},"name":{"type":"string","minLength":1,"maxLength":100}},"required":["runId","installationId","sessionId","name"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"provider":{"type":"string"},"state":{"type":"string","enum":["active","idle","attention","ended"]},"availability":{"type":"string","enum":["active","idle","offline"]},"activityAt":{"type":["string","null"]},"connectedUntil":{"type":["string","null"]}},"required":["id","name","provider","state","availability","activityAt","connectedUntil"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/coordination/heartbeat":{"post":{"operationId":"heartbeatAgentRuns","summary":"Refresh installation connectivity and chat lifecycle","description":"Task-scoped agent coordination. Project coordination must be enabled by a human administrator. Availability is advisory; no timeout releases task ownership. Mutations require an Idempotency-Key.\nRequired application permissions: tasks:read, tasks:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["coordination"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read","tasks:write"],"x-project-access":true,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"installationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"runs":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"runId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sequence":{"type":"integer","minimum":0,"maximum":2147483647},"state":{"type":"string","enum":["active","idle","attention","ended"]}},"required":["runId","sequence","state"],"additionalProperties":false}}},"required":["installationId","runs"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"provider":{"type":"string"},"state":{"type":"string","enum":["active","idle","attention","ended"]},"availability":{"type":"string","enum":["active","idle","offline"]},"activityAt":{"type":["string","null"]},"connectedUntil":{"type":["string","null"]}},"required":["id","name","provider","state","availability","activityAt","connectedUntil"]}}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/tasks/{id}/agents":{"get":{"operationId":"getTaskAgents","summary":"Read task chats, presence and conversation","description":"Task-scoped agent coordination. Project coordination must be enabled by a human administrator. Availability is advisory; no timeout releases task ownership. Mutations require an Idempotency-Key.\nRequired application permissions: tasks:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["tasks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"beforeId","in":"query","required":false,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"enabled":{"type":"boolean"},"projectId":{"type":"string"},"canConfigure":{"type":"boolean"},"chats":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"provider":{"type":"string"},"state":{"type":"string","enum":["active","idle","attention","ended"]},"availability":{"type":"string","enum":["active","idle","offline"]},"activityAt":{"type":["string","null"]},"connectedUntil":{"type":["string","null"]},"repository":{"type":"string"},"branch":{"type":"string"},"files":{"type":"array","items":{"type":"string"}},"checkpoint":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","provider","state","availability","activityAt","connectedUntil","repository","branch","files","checkpoint","updatedAt"]}},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"taskId":{"type":"string"},"senderRunId":{"type":["string","null"]},"senderName":{"type":"string"},"recipientRunId":{"type":["string","null"]},"kind":{"type":"string","enum":["question","note","reply"]},"replyToId":{"type":["string","null"]},"body":{"type":"string"},"createdAt":{"type":"string"},"deadlineAt":{"type":["string","null"]},"deliveredAt":{"type":["string","null"]},"repliedAt":{"type":["string","null"]},"responseState":{"type":"string","enum":["note","waiting","no_reply","replied","late_reply"]},"reply":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"body":{"type":"string"},"senderRunId":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","body","senderRunId","createdAt"]},{"type":"null"}]},"recipientAvailability":{"type":"string","enum":["active","idle","offline"]}},"required":["id","taskId","senderRunId","senderName","recipientRunId","kind","replyToId","body","createdAt","deadlineAt","deliveredAt","repliedAt","responseState","reply"]}},"nextBeforeId":{"type":["string","null"]},"sampledAt":{"type":"string"}},"required":["enabled","projectId","canConfigure","chats","messages","nextBeforeId","sampledAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"post":{"operationId":"linkTaskAgent","summary":"Link this chat and declare work scope","description":"Task-scoped agent coordination. Project coordination must be enabled by a human administrator. Availability is advisory; no timeout releases task ownership. Mutations require an Idempotency-Key.\nRequired application permissions: tasks:read, tasks:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["tasks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read","tasks:write"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"runId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"repository":{"default":"","type":"string","maxLength":300},"branch":{"default":"","type":"string","maxLength":200},"files":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":300}},"checkpoint":{"default":"","type":"string","maxLength":2000}},"required":["runId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"provider":{"type":"string"},"state":{"type":"string","enum":["active","idle","attention","ended"]},"availability":{"type":"string","enum":["active","idle","offline"]},"activityAt":{"type":["string","null"]},"connectedUntil":{"type":["string","null"]},"repository":{"type":"string"},"branch":{"type":"string"},"files":{"type":"array","items":{"type":"string"}},"checkpoint":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","name","provider","state","availability","activityAt","connectedUntil","repository","branch","files","checkpoint","updatedAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/tasks/{id}/agent-messages":{"post":{"operationId":"sendAgentMessage","summary":"Ask an active agent or leave a task message","description":"Task-scoped agent coordination. Project coordination must be enabled by a human administrator. Availability is advisory; no timeout releases task ownership. Mutations require an Idempotency-Key.\nRequired application permissions: tasks:read, tasks:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["tasks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read","tasks:write"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"messageId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"senderRunId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recipientRunId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"default":"question","type":"string","enum":["question","note"]},"body":{"type":"string","minLength":1,"maxLength":2000}},"required":["recipientRunId","body"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"taskId":{"type":"string"},"senderRunId":{"type":["string","null"]},"senderName":{"type":"string"},"recipientRunId":{"type":["string","null"]},"kind":{"type":"string","enum":["question","note","reply"]},"replyToId":{"type":["string","null"]},"body":{"type":"string"},"createdAt":{"type":"string"},"deadlineAt":{"type":["string","null"]},"deliveredAt":{"type":["string","null"]},"repliedAt":{"type":["string","null"]},"responseState":{"type":"string","enum":["note","waiting","no_reply","replied","late_reply"]},"reply":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"body":{"type":"string"},"senderRunId":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","body","senderRunId","createdAt"]},{"type":"null"}]},"recipientAvailability":{"type":"string","enum":["active","idle","offline"]}},"required":["id","taskId","senderRunId","senderName","recipientRunId","kind","replyToId","body","createdAt","deadlineAt","deliveredAt","repliedAt","responseState","reply"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/agent-messages/{id}":{"get":{"operationId":"getAgentMessage","summary":"Read reply or timeout status","description":"Task-scoped agent coordination. Project coordination must be enabled by a human administrator. Availability is advisory; no timeout releases task ownership. Mutations require an Idempotency-Key.\nRequired application permissions: tasks:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["agent-messages"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"taskId":{"type":"string"},"senderRunId":{"type":["string","null"]},"senderName":{"type":"string"},"recipientRunId":{"type":["string","null"]},"kind":{"type":"string","enum":["question","note","reply"]},"replyToId":{"type":["string","null"]},"body":{"type":"string"},"createdAt":{"type":"string"},"deadlineAt":{"type":["string","null"]},"deliveredAt":{"type":["string","null"]},"repliedAt":{"type":["string","null"]},"responseState":{"type":"string","enum":["note","waiting","no_reply","replied","late_reply"]},"reply":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"body":{"type":"string"},"senderRunId":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","body","senderRunId","createdAt"]},{"type":"null"}]},"recipientAvailability":{"type":"string","enum":["active","idle","offline"]}},"required":["id","taskId","senderRunId","senderName","recipientRunId","kind","replyToId","body","createdAt","deadlineAt","deliveredAt","repliedAt","responseState","reply"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/agent-messages/{id}/reply":{"post":{"operationId":"replyAgentMessage","summary":"Reply as the addressed chat run","description":"Task-scoped agent coordination. Project coordination must be enabled by a human administrator. Availability is advisory; no timeout releases task ownership. Mutations require an Idempotency-Key.\nRequired application permissions: tasks:read, tasks:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["agent-messages"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read","tasks:write"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"runId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"body":{"type":"string","minLength":1,"maxLength":2000}},"required":["runId","body"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"taskId":{"type":"string"},"senderRunId":{"type":["string","null"]},"senderName":{"type":"string"},"recipientRunId":{"type":["string","null"]},"kind":{"type":"string","enum":["question","note","reply"]},"replyToId":{"type":["string","null"]},"body":{"type":"string"},"createdAt":{"type":"string"},"deadlineAt":{"type":["string","null"]},"deliveredAt":{"type":["string","null"]},"repliedAt":{"type":["string","null"]},"responseState":{"type":"string","enum":["note","waiting","no_reply","replied","late_reply"]},"reply":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"body":{"type":"string"},"senderRunId":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","body","senderRunId","createdAt"]},{"type":"null"}]},"recipientAvailability":{"type":"string","enum":["active","idle","offline"]}},"required":["id","taskId","senderRunId","senderName","recipientRunId","kind","replyToId","body","createdAt","deadlineAt","deliveredAt","repliedAt","responseState","reply"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/coordination/inbox":{"get":{"operationId":"getAgentInbox","summary":"Read this installation’s undelivered task messages","description":"Task-scoped agent coordination. Project coordination must be enabled by a human administrator. Availability is advisory; no timeout releases task ownership. Mutations require an Idempotency-Key.\nRequired application permissions: tasks:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["coordination"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read"],"x-project-access":true,"parameters":[{"name":"installationId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"runId","in":"query","required":false,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"taskId":{"type":"string"},"senderRunId":{"type":["string","null"]},"senderName":{"type":"string"},"recipientRunId":{"type":["string","null"]},"kind":{"type":"string","enum":["question","note","reply"]},"replyToId":{"type":["string","null"]},"body":{"type":"string"},"createdAt":{"type":"string"},"deadlineAt":{"type":["string","null"]},"deliveredAt":{"type":["string","null"]},"repliedAt":{"type":["string","null"]},"responseState":{"type":"string","enum":["note","waiting","no_reply","replied","late_reply"]},"reply":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"body":{"type":"string"},"senderRunId":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","body","senderRunId","createdAt"]},{"type":"null"}]},"recipientAvailability":{"type":"string","enum":["active","idle","offline"]}},"required":["id","taskId","senderRunId","senderName","recipientRunId","kind","replyToId","body","createdAt","deadlineAt","deliveredAt","repliedAt","responseState","reply"]}},"sampledAt":{"type":"string"}},"required":["messages","sampledAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/coordination/ack":{"post":{"operationId":"acknowledgeAgentMessages","summary":"Acknowledge delivered context without implying a reply","description":"Task-scoped agent coordination. Project coordination must be enabled by a human administrator. Availability is advisory; no timeout releases task ownership. Mutations require an Idempotency-Key.\nRequired application permissions: tasks:read, tasks:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["coordination"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read","tasks:write"],"x-project-access":true,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"installationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"runId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"messageIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["installationId","messageIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"acknowledged":{"type":"array","items":{"type":"string"}}},"required":["acknowledged"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/invitations/{id}":{"get":{"operationId":"getInvitation","summary":"Read an organization invitation","description":"Read an organization invitation\nRequired application permissions: members:read, team:write. Requires an organization-wide key.","tags":["invitations"],"security":[{"bearerAuth":[]}],"x-required-scopes":["members:read","team:write"],"x-project-access":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"email":{"type":"string"},"role":{"type":"string"},"status":{"type":"string"},"expiresAt":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","email","role","status","expiresAt","createdAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/context":{"get":{"operationId":"getContext","summary":"Discover the organization, identity, scopes, and available operations","description":"Discover the organization, identity, scopes, and available operations\nRequired application permissions: any valid key. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["context"],"security":[{"bearerAuth":[]}],"x-required-scopes":[],"x-project-access":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"organization":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"timezone":{"type":"string"},"weekStartsOn":{"type":"number"},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezoneLocked":{"type":"boolean"}},"required":["id","name","timezone","weekStartsOn","version","timezoneLocked"]},"userId":{"type":"string","minLength":1,"maxLength":200},"role":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"operations":{"type":"array","items":{"type":"string"}},"access":{"type":"object","properties":{"type":{"type":"string","enum":["organization","project"]},"projectId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"projectName":{"type":["string","null"]}},"required":["type","projectId","projectName"]}},"required":["organization","userId","role","scopes","operations","access"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/organization":{"get":{"operationId":"getOrganization","summary":"Read organization settings","description":"Read organization settings\nRequired application permissions: organization:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["organization"],"security":[{"bearerAuth":[]}],"x-required-scopes":["organization:read"],"x-project-access":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"timezone":{"type":"string"},"weekStartsOn":{"type":"number"},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezoneLocked":{"type":"boolean"}},"required":["id","name","timezone","weekStartsOn","version","timezoneLocked"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"patch":{"operationId":"updateOrganization","summary":"Update organization name or timezone","description":"Update organization name or timezone\nRequired application permissions: organization:read, organization:write. Requires an organization-wide key.","tags":["organization"],"security":[{"bearerAuth":[]}],"x-required-scopes":["organization:read","organization:write"],"x-project-access":false,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"name":{"type":"string","minLength":1,"maxLength":100},"timezone":{"type":"string","minLength":1,"maxLength":100}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"timezone":{"type":"string"},"weekStartsOn":{"type":"number"},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezoneLocked":{"type":"boolean"}},"required":["id","name","timezone","weekStartsOn","version","timezoneLocked"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/tasks":{"get":{"operationId":"listTasks","summary":"Search and paginate all tasks, including completed history","description":"Filters combine with AND; tagIds match any supplied tag. assigneeId=unassigned selects unassigned tasks. Traversal is live, sorted by ID. Reuse the same filters and limit with nextCursor.\nRequired application permissions: tasks:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["tasks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read"],"x-project-access":true,"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":4000}},{"name":"query","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"projectId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"clientId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"assigneeId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"statusId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"statusCategory","in":"query","required":false,"schema":{"type":"string","enum":["not_started","in_progress","completed"]}},{"name":"dueFrom","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"dueTo","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"tagIds","in":"query","required":false,"schema":{"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"style":"form","explode":true}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"description":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"assigneeId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentKeyId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentName":{"type":["string","null"]},"dueOn":{"type":["string","null"]},"statusId":{"type":"string","minLength":1,"maxLength":200},"statusCategory":{"type":"string","enum":["not_started","in_progress","completed"]},"result":{"type":"string"},"completedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"boardRank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"}},"required":["id","name"]}}},"required":["id","title","description","projectId","assigneeId","assigneeAgentKeyId","assigneeAgentName","dueOn","statusId","statusCategory","result","completedAt","version","createdAt","boardRank","tags"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}},"required":["data","page"],"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"post":{"operationId":"createTask","summary":"Create and optionally assign a task","description":"Creates an unfinished task. Omitted assigneeId and dueOn default to null. Description defaults to empty and tags to []. Discover project/user/status IDs before creating.\nRequired application permissions: tasks:read, tasks:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["tasks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read","tasks:write"],"x-project-access":true,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200},"projectId":{"type":"string","minLength":1,"maxLength":200},"assigneeId":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"dueOn":{"default":null,"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"description":{"default":"","type":"string","maxLength":5000},"result":{"not":{}},"tags":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"statusId":{"type":"string","minLength":1,"maxLength":200}},"required":["title","projectId"],"additionalProperties":false}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"description":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"assigneeId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentKeyId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentName":{"type":["string","null"]},"dueOn":{"type":["string","null"]},"statusId":{"type":"string","minLength":1,"maxLength":200},"statusCategory":{"type":"string","enum":["not_started","in_progress","completed"]},"result":{"type":"string"},"completedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"boardRank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"}},"required":["id","name"]}}},"required":["id","title","description","projectId","assigneeId","assigneeAgentKeyId","assigneeAgentName","dueOn","statusId","statusCategory","result","completedAt","version","createdAt","boardRank","tags"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/tasks/{id}":{"get":{"operationId":"getTask","summary":"Read a task and its version","description":"Read a task and its version\nRequired application permissions: tasks:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["tasks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"description":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"assigneeId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentKeyId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentName":{"type":["string","null"]},"dueOn":{"type":["string","null"]},"statusId":{"type":"string","minLength":1,"maxLength":200},"statusCategory":{"type":"string","enum":["not_started","in_progress","completed"]},"result":{"type":"string"},"completedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"boardRank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"}},"required":["id","name"]}}},"required":["id","title","description","projectId","assigneeId","assigneeAgentKeyId","assigneeAgentName","dueOn","statusId","statusCategory","result","completedAt","version","createdAt","boardRank","tags"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"patch":{"operationId":"updateTask","summary":"Atomically update supplied task metadata","description":"Omitted fields are preserved. null clears assigneeId/dueOn, [] clears tags. expectedVersion is required. Moving a task with recorded time is forbidden. Read/merge/write executes under one organization lock and transaction.\nRequired application permissions: tasks:read, tasks:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["tasks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read","tasks:write"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200},"projectId":{"type":"string","minLength":1,"maxLength":200},"assigneeId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"dueOn":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"description":{"type":"string","maxLength":5000},"result":{"type":"string","maxLength":5000},"tags":{"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":60}},"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"description":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"assigneeId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentKeyId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentName":{"type":["string","null"]},"dueOn":{"type":["string","null"]},"statusId":{"type":"string","minLength":1,"maxLength":200},"statusCategory":{"type":"string","enum":["not_started","in_progress","completed"]},"result":{"type":"string"},"completedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"boardRank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"}},"required":["id","name"]}}},"required":["id","title","description","projectId","assigneeId","assigneeAgentKeyId","assigneeAgentName","dueOn","statusId","statusCategory","result","completedAt","version","createdAt","boardRank","tags"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"delete":{"operationId":"deleteTask","summary":"Delete a task without recorded time","description":"Delete a task without recorded time\nRequired application permissions: tasks:read, tasks:delete. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["tasks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read","tasks:delete"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"expectedVersion","in":"query","required":true,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Deleted"},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/tasks/{id}/status":{"post":{"operationId":"changeTaskStatus","summary":"Move a task to a discovered workflow status","description":"Requires current task and workflow versions. Completion/result locks and running timers apply. Moving an unassigned task into an In progress status assigns it to the key's creator unless claimIfUnassigned is false; other moves preserve the assignee. When the key's creator is the assignee, assigneeAgentKeyId/assigneeAgentName identify the key that took or started the task.\nRequired application permissions: tasks:read, tasks:write, workflow:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["tasks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read","tasks:write","workflow:read"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"statusId":{"type":"string","minLength":1,"maxLength":200},"expectedWorkflowVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"result":{"type":"string","maxLength":5000},"claimIfUnassigned":{"type":"boolean"}},"required":["expectedVersion","statusId","expectedWorkflowVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"description":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"assigneeId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentKeyId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentName":{"type":["string","null"]},"dueOn":{"type":["string","null"]},"statusId":{"type":"string","minLength":1,"maxLength":200},"statusCategory":{"type":"string","enum":["not_started","in_progress","completed"]},"result":{"type":"string"},"completedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"boardRank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"}},"required":["id","name"]}}},"required":["id","title","description","projectId","assigneeId","assigneeAgentKeyId","assigneeAgentName","dueOn","statusId","statusCategory","result","completedAt","version","createdAt","boardRank","tags"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/tasks/{id}/complete":{"post":{"operationId":"completeTask","summary":"Complete a task and optionally save its result","description":"Complete a task and optionally save its result\nRequired application permissions: tasks:read, tasks:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["tasks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read","tasks:write"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"result":{"type":"string","maxLength":5000}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"description":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"assigneeId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentKeyId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentName":{"type":["string","null"]},"dueOn":{"type":["string","null"]},"statusId":{"type":"string","minLength":1,"maxLength":200},"statusCategory":{"type":"string","enum":["not_started","in_progress","completed"]},"result":{"type":"string"},"completedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"boardRank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"}},"required":["id","name"]}}},"required":["id","title","description","projectId","assigneeId","assigneeAgentKeyId","assigneeAgentName","dueOn","statusId","statusCategory","result","completedAt","version","createdAt","boardRank","tags"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/tasks/{id}/reopen":{"post":{"operationId":"reopenTask","summary":"Reopen a completed task","description":"Reopen a completed task\nRequired application permissions: tasks:read, tasks:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["tasks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read","tasks:write"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"description":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"assigneeId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentKeyId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentName":{"type":["string","null"]},"dueOn":{"type":["string","null"]},"statusId":{"type":"string","minLength":1,"maxLength":200},"statusCategory":{"type":"string","enum":["not_started","in_progress","completed"]},"result":{"type":"string"},"completedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"boardRank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"}},"required":["id","name"]}}},"required":["id","title","description","projectId","assigneeId","assigneeAgentKeyId","assigneeAgentName","dueOn","statusId","statusCategory","result","completedAt","version","createdAt","boardRank","tags"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/tasks/{id}/position":{"post":{"operationId":"positionTask","summary":"Reorder a task within its current board column","description":"Reorder a task within its current board column\nRequired application permissions: tasks:read, tasks:write, workflow:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["tasks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read","tasks:write","workflow:read"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"expectedWorkflowVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"beforeId":{"type":"string","minLength":1,"maxLength":200}},"required":["expectedVersion","expectedWorkflowVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"description":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"assigneeId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentKeyId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentName":{"type":["string","null"]},"dueOn":{"type":["string","null"]},"statusId":{"type":"string","minLength":1,"maxLength":200},"statusCategory":{"type":"string","enum":["not_started","in_progress","completed"]},"result":{"type":"string"},"completedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"boardRank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"}},"required":["id","name"]}}},"required":["id","title","description","projectId","assigneeId","assigneeAgentKeyId","assigneeAgentName","dueOn","statusId","statusCategory","result","completedAt","version","createdAt","boardRank","tags"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/projects":{"get":{"operationId":"listProjects","summary":"Discover active and archived projects","description":"Discover active and archived projects\nRequired application permissions: projects:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["projects"],"security":[{"bearerAuth":[]}],"x-required-scopes":["projects:read"],"x-project-access":true,"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":4000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"clientId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"budgetSeconds":{"type":["number","null"]},"billableDefault":{"type":"boolean"},"archivedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","name","clientId","budgetSeconds","billableDefault","archivedAt","version","createdAt"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}},"required":["data","page"],"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"post":{"operationId":"createProject","summary":"Create a project with an optional existing client","description":"Create a project with an optional existing client\nRequired application permissions: projects:read, projects:write. Requires an organization-wide key.","tags":["projects"],"security":[{"bearerAuth":[]}],"x-required-scopes":["projects:read","projects:write"],"x-project-access":false,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"clientId":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"budgetHours":{"default":null,"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"billableDefault":{"default":false,"type":"boolean"}},"required":["name"],"additionalProperties":false}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"clientId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"budgetSeconds":{"type":["number","null"]},"billableDefault":{"type":"boolean"},"archivedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","name","clientId","budgetSeconds","billableDefault","archivedAt","version","createdAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/projects/{id}":{"get":{"operationId":"getProject","summary":"Read a project","description":"Read a project\nRequired application permissions: projects:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["projects"],"security":[{"bearerAuth":[]}],"x-required-scopes":["projects:read"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"clientId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"budgetSeconds":{"type":["number","null"]},"billableDefault":{"type":"boolean"},"archivedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","name","clientId","budgetSeconds","billableDefault","archivedAt","version","createdAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"patch":{"operationId":"updateProject","summary":"Update supplied project fields","description":"Update supplied project fields\nRequired application permissions: projects:read, projects:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["projects"],"security":[{"bearerAuth":[]}],"x-required-scopes":["projects:read","projects:write"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"clientId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"budgetHours":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"billableDefault":{"type":"boolean"},"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"clientId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"budgetSeconds":{"type":["number","null"]},"billableDefault":{"type":"boolean"},"archivedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","name","clientId","budgetSeconds","billableDefault","archivedAt","version","createdAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"delete":{"operationId":"deleteProject","summary":"Delete a project without recorded time","description":"Delete a project without recorded time\nRequired application permissions: projects:read, projects:delete. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["projects"],"security":[{"bearerAuth":[]}],"x-required-scopes":["projects:read","projects:delete"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"expectedVersion","in":"query","required":true,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Deleted"},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/projects/{id}/archive":{"post":{"operationId":"archiveProject","summary":"Archive a project","description":"Archive a project\nRequired application permissions: projects:read, projects:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["projects"],"security":[{"bearerAuth":[]}],"x-required-scopes":["projects:read","projects:write"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"clientId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"budgetSeconds":{"type":["number","null"]},"billableDefault":{"type":"boolean"},"archivedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","name","clientId","budgetSeconds","billableDefault","archivedAt","version","createdAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/projects/{id}/restore":{"post":{"operationId":"restoreProject","summary":"Restore a project","description":"Restore a project\nRequired application permissions: projects:read, projects:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["projects"],"security":[{"bearerAuth":[]}],"x-required-scopes":["projects:read","projects:write"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"clientId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"budgetSeconds":{"type":["number","null"]},"billableDefault":{"type":"boolean"},"archivedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","name","clientId","budgetSeconds","billableDefault","archivedAt","version","createdAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/clients":{"get":{"operationId":"listClients","summary":"Discover clients","description":"Discover clients\nRequired application permissions: clients:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["clients"],"security":[{"bearerAuth":[]}],"x-required-scopes":["clients:read"],"x-project-access":true,"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":4000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"archivedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","name","archivedAt","version","createdAt"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}},"required":["data","page"],"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"post":{"operationId":"createClient","summary":"Create a client","description":"Create a client\nRequired application permissions: clients:read, clients:write. Requires an organization-wide key.","tags":["clients"],"security":[{"bearerAuth":[]}],"x-required-scopes":["clients:read","clients:write"],"x-project-access":false,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100}},"required":["name"],"additionalProperties":false}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"archivedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","name","archivedAt","version","createdAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/clients/{id}":{"get":{"operationId":"getClient","summary":"Read a client","description":"Read a client\nRequired application permissions: clients:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["clients"],"security":[{"bearerAuth":[]}],"x-required-scopes":["clients:read"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"archivedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","name","archivedAt","version","createdAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"patch":{"operationId":"updateClient","summary":"Rename a client","description":"Rename a client\nRequired application permissions: clients:read, clients:write. Requires an organization-wide key.","tags":["clients"],"security":[{"bearerAuth":[]}],"x-required-scopes":["clients:read","clients:write"],"x-project-access":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"name":{"type":"string","minLength":1,"maxLength":100}},"required":["expectedVersion","name"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"archivedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","name","archivedAt","version","createdAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/clients/{id}/archive":{"post":{"operationId":"archiveClient","summary":"Archive a client","description":"Archive a client\nRequired application permissions: clients:read, clients:write. Requires an organization-wide key.","tags":["clients"],"security":[{"bearerAuth":[]}],"x-required-scopes":["clients:read","clients:write"],"x-project-access":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"archivedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","name","archivedAt","version","createdAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/clients/{id}/restore":{"post":{"operationId":"restoreClient","summary":"Restore a client","description":"Restore a client\nRequired application permissions: clients:read, clients:write. Requires an organization-wide key.","tags":["clients"],"security":[{"bearerAuth":[]}],"x-required-scopes":["clients:read","clients:write"],"x-project-access":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"archivedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","name","archivedAt","version","createdAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/members":{"get":{"operationId":"listMembers","summary":"Discover membership IDs and user IDs for assignment","description":"Discover membership IDs and user IDs for assignment\nRequired application permissions: members:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["members"],"security":[{"bearerAuth":[]}],"x-required-scopes":["members:read"],"x-project-access":true,"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":4000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"userId":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","userId","name","role","version"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}},"required":["data","page"],"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/workflow":{"get":{"operationId":"getWorkflow","summary":"Read statuses, columns, and workflow version","description":"Read statuses, columns, and workflow version\nRequired application permissions: workflow:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["workflow"],"security":[{"bearerAuth":[]}],"x-required-scopes":["workflow:read"],"x-project-access":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"completedLimit":{"type":"number"},"columns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string","maxLength":60},"category":{"type":"string","enum":["not_started","in_progress","completed"]},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","name","category","position"]}},"statuses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string","maxLength":60},"category":{"type":"string","enum":["not_started","in_progress","completed"]},"columnId":{"type":"string","minLength":1,"maxLength":200},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"isDefault":{"type":"boolean"}},"required":["id","name","category","columnId","position","color","isDefault"]}}},"required":["version","completedLimit","columns","statuses"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"put":{"operationId":"saveWorkflow","summary":"Atomically save workflow configuration and replacement mappings","description":"Atomically save workflow configuration and replacement mappings\nRequired application permissions: workflow:read, workflow:write. Requires an organization-wide key.","tags":["workflow"],"security":[{"bearerAuth":[]}],"x-required-scopes":["workflow:read","workflow:write"],"x-project-access":false,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"completedLimit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columns":{"maxItems":12,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string","maxLength":60},"category":{"type":"string","enum":["not_started","in_progress","completed"]},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","name","category","position"],"additionalProperties":false}},"statuses":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string","maxLength":60},"category":{"type":"string","enum":["not_started","in_progress","completed"]},"columnId":{"type":"string","minLength":1,"maxLength":200},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"isDefault":{"type":"boolean"}},"required":["id","name","category","columnId","position","color","isDefault"],"additionalProperties":false}},"replacements":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["expectedVersion","completedLimit","columns","statuses","replacements"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"completedLimit":{"type":"number"},"columns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string","maxLength":60},"category":{"type":"string","enum":["not_started","in_progress","completed"]},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","name","category","position"]}},"statuses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string","maxLength":60},"category":{"type":"string","enum":["not_started","in_progress","completed"]},"columnId":{"type":"string","minLength":1,"maxLength":200},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"isDefault":{"type":"boolean"}},"required":["id","name","category","columnId","position","color","isDefault"]}}},"required":["version","completedLimit","columns","statuses"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/tags":{"get":{"operationId":"listTags","summary":"Discover shared workspace tags","description":"Discover shared workspace tags\nRequired application permissions: tasks:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["tags"],"security":[{"bearerAuth":[]}],"x-required-scopes":["tasks:read"],"x-project-access":true,"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":4000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"}},"required":["id","name"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}},"required":["data","page"],"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/time-entries":{"get":{"operationId":"listOwnTimeEntries","summary":"Read creator-owned entries for an organization-local day","description":"Entries belong only to the key creator. date defaults to the current organization-local date. meta.version is the shared time/timer version required by corrections and timer commands.\nRequired application permissions: time:own:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["time-entries"],"security":[{"bearerAuth":[]}],"x-required-scopes":["time:own:read"],"x-project-access":true,"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":4000}},{"name":"date","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"projectId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"taskId":{"type":"string","minLength":1,"maxLength":200},"projectId":{"type":"string","minLength":1,"maxLength":200},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]},"note":{"type":"string"},"billable":{"type":"boolean"}},"required":["id","taskId","projectId","startedAt","stoppedAt","note","billable"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}},"required":["data","page"],"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"post":{"operationId":"createOwnTimeEntry","summary":"Create creator-owned manual time","description":"Use taskId/projectId plus exact startedAt/stoppedAt, or workDate/durationMilliseconds. Existing overlap, date/DST, and submitted-week rules apply. expectedVersion is the shared time/timer version.\nRequired application permissions: time:own:read, time:own:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["time-entries"],"security":[{"bearerAuth":[]}],"x-required-scopes":["time:own:read","time:own:write"],"x-project-access":true,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"taskId":{"type":"string","minLength":1,"maxLength":200},"projectId":{"type":"string","minLength":1,"maxLength":200},"startedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"stoppedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"workDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"durationMilliseconds":{"type":"integer","minimum":60000,"maximum":86400000},"note":{"type":"string","maxLength":5000},"billable":{"type":"boolean"},"reason":{"type":"string","maxLength":500}},"required":["expectedVersion","taskId","projectId"],"additionalProperties":false}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"taskId":{"type":"string","minLength":1,"maxLength":200},"projectId":{"type":"string","minLength":1,"maxLength":200},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]},"note":{"type":"string"},"billable":{"type":"boolean"},"version":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","taskId","projectId","startedAt","stoppedAt","note","billable","version"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/time-entries/{id}":{"get":{"operationId":"getOwnTimeEntry","summary":"Read a creator-owned time entry","description":"Read a creator-owned time entry\nRequired application permissions: time:own:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["time-entries"],"security":[{"bearerAuth":[]}],"x-required-scopes":["time:own:read"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"taskId":{"type":"string","minLength":1,"maxLength":200},"projectId":{"type":"string","minLength":1,"maxLength":200},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]},"note":{"type":"string"},"billable":{"type":"boolean"},"version":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","taskId","projectId","startedAt","stoppedAt","note","billable","version"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"patch":{"operationId":"updateOwnTimeEntry","summary":"Correct creator-owned time","description":"Correct creator-owned time\nRequired application permissions: time:own:read, time:own:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["time-entries"],"security":[{"bearerAuth":[]}],"x-required-scopes":["time:own:read","time:own:write"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"taskId":{"type":"string","minLength":1,"maxLength":200},"projectId":{"type":"string","minLength":1,"maxLength":200},"startedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"stoppedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"note":{"type":"string","maxLength":5000},"billable":{"type":"boolean"},"reason":{"type":"string","maxLength":500}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"taskId":{"type":"string","minLength":1,"maxLength":200},"projectId":{"type":"string","minLength":1,"maxLength":200},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]},"note":{"type":"string"},"billable":{"type":"boolean"},"version":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","taskId","projectId","startedAt","stoppedAt","note","billable","version"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"delete":{"operationId":"deleteOwnTimeEntry","summary":"Delete creator-owned manual time","description":"Delete creator-owned manual time\nRequired application permissions: time:own:read, time:own:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["time-entries"],"security":[{"bearerAuth":[]}],"x-required-scopes":["time:own:read","time:own:write"],"x-project-access":true,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"expectedVersion","in":"query","required":true,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"reason","in":"query","required":false,"schema":{"type":"string","maxLength":500}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Deleted"},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/timer":{"get":{"operationId":"getOwnTimer","summary":"Read the creator's current timer","description":"Read the creator's current timer\nRequired application permissions: timers:own:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["timer"],"security":[{"bearerAuth":[]}],"x-required-scopes":["timers:own:read"],"x-project-access":true,"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"mode":{"type":"string","enum":["stopped","running","paused"]},"sampledAt":{"type":"string"},"elapsedSeconds":{"type":"number"},"task":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"clientName":{"type":["string","null"]}},"required":["id","title","projectId","projectName","clientName"]},{"type":"null"}]},"resumeError":{"type":["string","null"]},"entry":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"note":{"type":"string"},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]}},"required":["id","note","startedAt","stoppedAt"]},{"type":"null"}]},"taskSeconds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["version","mode","sampledAt","elapsedSeconds","task","resumeError","entry","taskSeconds"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/timer/start":{"post":{"operationId":"startOwnTimer","summary":"Start or switch the creator's timer","description":"Start or switch the creator's timer\nRequired application permissions: timers:own:read, timers:own:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["timer"],"security":[{"bearerAuth":[]}],"x-required-scopes":["timers:own:read","timers:own:write"],"x-project-access":true,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"taskId":{"type":"string","minLength":1,"maxLength":200}},"required":["expectedVersion","taskId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"mode":{"type":"string","enum":["stopped","running","paused"]},"sampledAt":{"type":"string"},"elapsedSeconds":{"type":"number"},"task":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"clientName":{"type":["string","null"]}},"required":["id","title","projectId","projectName","clientName"]},{"type":"null"}]},"resumeError":{"type":["string","null"]},"entry":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"note":{"type":"string"},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]}},"required":["id","note","startedAt","stoppedAt"]},{"type":"null"}]},"taskSeconds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["version","mode","sampledAt","elapsedSeconds","task","resumeError","entry","taskSeconds"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/timer/pause":{"post":{"operationId":"pauseOwnTimer","summary":"pause the creator's timer","description":"pause the creator's timer\nRequired application permissions: timers:own:read, timers:own:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["timer"],"security":[{"bearerAuth":[]}],"x-required-scopes":["timers:own:read","timers:own:write"],"x-project-access":true,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"mode":{"type":"string","enum":["stopped","running","paused"]},"sampledAt":{"type":"string"},"elapsedSeconds":{"type":"number"},"task":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"clientName":{"type":["string","null"]}},"required":["id","title","projectId","projectName","clientName"]},{"type":"null"}]},"resumeError":{"type":["string","null"]},"entry":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"note":{"type":"string"},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]}},"required":["id","note","startedAt","stoppedAt"]},{"type":"null"}]},"taskSeconds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["version","mode","sampledAt","elapsedSeconds","task","resumeError","entry","taskSeconds"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/timer/resume":{"post":{"operationId":"resumeOwnTimer","summary":"resume the creator's timer","description":"resume the creator's timer\nRequired application permissions: timers:own:read, timers:own:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["timer"],"security":[{"bearerAuth":[]}],"x-required-scopes":["timers:own:read","timers:own:write"],"x-project-access":true,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"mode":{"type":"string","enum":["stopped","running","paused"]},"sampledAt":{"type":"string"},"elapsedSeconds":{"type":"number"},"task":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"clientName":{"type":["string","null"]}},"required":["id","title","projectId","projectName","clientName"]},{"type":"null"}]},"resumeError":{"type":["string","null"]},"entry":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"note":{"type":"string"},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]}},"required":["id","note","startedAt","stoppedAt"]},{"type":"null"}]},"taskSeconds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["version","mode","sampledAt","elapsedSeconds","task","resumeError","entry","taskSeconds"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/timer/stop":{"post":{"operationId":"stopOwnTimer","summary":"stop the creator's timer","description":"stop the creator's timer\nRequired application permissions: timers:own:read, timers:own:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["timer"],"security":[{"bearerAuth":[]}],"x-required-scopes":["timers:own:read","timers:own:write"],"x-project-access":true,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"mode":{"type":"string","enum":["stopped","running","paused"]},"sampledAt":{"type":"string"},"elapsedSeconds":{"type":"number"},"task":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"clientName":{"type":["string","null"]}},"required":["id","title","projectId","projectName","clientName"]},{"type":"null"}]},"resumeError":{"type":["string","null"]},"entry":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"note":{"type":"string"},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]}},"required":["id","note","startedAt","stoppedAt"]},{"type":"null"}]},"taskSeconds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["version","mode","sampledAt","elapsedSeconds","task","resumeError","entry","taskSeconds"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/timer/note":{"patch":{"operationId":"updateOwnTimerNote","summary":"Save the creator's private active work note","description":"Save the creator's private active work note\nRequired application permissions: timers:own:read, timers:own:write. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["timer"],"security":[{"bearerAuth":[]}],"x-required-scopes":["timers:own:read","timers:own:write"],"x-project-access":true,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"entryId":{"type":"string","minLength":1,"maxLength":200},"note":{"type":"string","maxLength":5000}},"required":["expectedVersion","entryId","note"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"mode":{"type":"string","enum":["stopped","running","paused"]},"sampledAt":{"type":"string"},"elapsedSeconds":{"type":"number"},"task":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"clientName":{"type":["string","null"]}},"required":["id","title","projectId","projectName","clientName"]},{"type":"null"}]},"resumeError":{"type":["string","null"]},"entry":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"note":{"type":"string"},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]}},"required":["id","note","startedAt","stoppedAt"]},{"type":"null"}]},"taskSeconds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"required":["version","mode","sampledAt","elapsedSeconds","task","resumeError","entry","taskSeconds"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/weeks/{week}":{"get":{"operationId":"getOwnWeek","summary":"Read the creator's week and version","description":"Read the creator's week and version\nRequired application permissions: reviews:own:read. Requires an organization-wide key.","tags":["weeks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["reviews:own:read"],"x-project-access":false,"parameters":[{"name":"week","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"week":{"type":"string"},"endsOn":{"type":"string"},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"sampledAt":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"locked":{"type":"boolean"}},"required":["date","seconds","billableSeconds","locked"]}},"review":{"type":"object","properties":{"status":{"type":"string","enum":["draft","submitted","returned","approved"]},"comment":{"type":"string"},"submittedAt":{"type":["string","null"]},"reviewedAt":{"type":["string","null"]},"reviewerName":{"type":["string","null"]}},"required":["status","comment","submittedAt","reviewedAt","reviewerName"]},"hasRunning":{"type":"boolean"},"hasOtherReviewer":{"type":"boolean"},"projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"}},"required":["date","seconds","billableSeconds"]}}},"required":["id","name","seconds","billableSeconds","days"]}},"outcomes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"completedAt":{"type":"string"},"result":{"type":"string"},"seconds":{"type":"number"}},"required":["id","title","projectId","projectName","completedAt","result","seconds"]}}},"required":["week","endsOn","version","timezone","sampledAt","seconds","billableSeconds","days","review","hasRunning","hasOtherReviewer","projects","outcomes"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/weeks/{week}/submit":{"post":{"operationId":"submitOwnWeek","summary":"submit the creator's whole week","description":"submit the creator's whole week\nRequired application permissions: reviews:own:read, reviews:own:write. Requires an organization-wide key.","tags":["weeks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["reviews:own:read","reviews:own:write"],"x-project-access":false,"parameters":[{"name":"week","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"comment":{"default":"","type":"string","maxLength":2000}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"week":{"type":"string"},"endsOn":{"type":"string"},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"sampledAt":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"locked":{"type":"boolean"}},"required":["date","seconds","billableSeconds","locked"]}},"review":{"type":"object","properties":{"status":{"type":"string","enum":["draft","submitted","returned","approved"]},"comment":{"type":"string"},"submittedAt":{"type":["string","null"]},"reviewedAt":{"type":["string","null"]},"reviewerName":{"type":["string","null"]}},"required":["status","comment","submittedAt","reviewedAt","reviewerName"]},"hasRunning":{"type":"boolean"},"hasOtherReviewer":{"type":"boolean"},"projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"}},"required":["date","seconds","billableSeconds"]}}},"required":["id","name","seconds","billableSeconds","days"]}},"outcomes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"completedAt":{"type":"string"},"result":{"type":"string"},"seconds":{"type":"number"}},"required":["id","title","projectId","projectName","completedAt","result","seconds"]}}},"required":["week","endsOn","version","timezone","sampledAt","seconds","billableSeconds","days","review","hasRunning","hasOtherReviewer","projects","outcomes"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/weeks/{week}/withdraw":{"post":{"operationId":"withdrawOwnWeek","summary":"withdraw the creator's whole week","description":"withdraw the creator's whole week\nRequired application permissions: reviews:own:read, reviews:own:write. Requires an organization-wide key.","tags":["weeks"],"security":[{"bearerAuth":[]}],"x-required-scopes":["reviews:own:read","reviews:own:write"],"x-project-access":false,"parameters":[{"name":"week","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"comment":{"default":"","type":"string","maxLength":2000}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"week":{"type":"string"},"endsOn":{"type":"string"},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"sampledAt":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"locked":{"type":"boolean"}},"required":["date","seconds","billableSeconds","locked"]}},"review":{"type":"object","properties":{"status":{"type":"string","enum":["draft","submitted","returned","approved"]},"comment":{"type":"string"},"submittedAt":{"type":["string","null"]},"reviewedAt":{"type":["string","null"]},"reviewerName":{"type":["string","null"]}},"required":["status","comment","submittedAt","reviewedAt","reviewerName"]},"hasRunning":{"type":"boolean"},"hasOtherReviewer":{"type":"boolean"},"projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"}},"required":["date","seconds","billableSeconds"]}}},"required":["id","name","seconds","billableSeconds","days"]}},"outcomes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"completedAt":{"type":"string"},"result":{"type":"string"},"seconds":{"type":"number"}},"required":["id","title","projectId","projectName","completedAt","result","seconds"]}}},"required":["week","endsOn","version","timezone","sampledAt","seconds","billableSeconds","days","review","hasRunning","hasOtherReviewer","projects","outcomes"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/reviews":{"get":{"operationId":"listReviews","summary":"Read the submitted review queue for a week","description":"Read the submitted review queue for a week\nRequired application permissions: reviews:team:read. Requires an organization-wide key.","tags":["reviews"],"security":[{"bearerAuth":[]}],"x-required-scopes":["reviews:team:read"],"x-project-access":false,"parameters":[{"name":"week","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"week":{"type":"string"},"timezone":{"type":"string"},"rows":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"currentMember":{"type":"boolean"},"seconds":{"type":"number"},"status":{"type":"string","enum":["submitted","returned","approved"]}},"required":["userId","name","currentMember","seconds","status"]}}},"required":["week","timezone","rows"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/reviews/{userId}/{week}":{"get":{"operationId":"getReview","summary":"Read a team member's review without private work notes","description":"Read a team member's review without private work notes\nRequired application permissions: reviews:team:read. Requires an organization-wide key.","tags":["reviews"],"security":[{"bearerAuth":[]}],"x-required-scopes":["reviews:team:read"],"x-project-access":false,"parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"week","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"week":{"type":"string"},"endsOn":{"type":"string"},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"sampledAt":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"locked":{"type":"boolean"}},"required":["date","seconds","billableSeconds","locked"]}},"review":{"type":"object","properties":{"status":{"type":"string","enum":["draft","submitted","returned","approved"]},"comment":{"type":"string"},"submittedAt":{"type":["string","null"]},"reviewedAt":{"type":["string","null"]},"reviewerName":{"type":["string","null"]}},"required":["status","comment","submittedAt","reviewedAt","reviewerName"]},"hasRunning":{"type":"boolean"},"hasOtherReviewer":{"type":"boolean"},"projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"}},"required":["date","seconds","billableSeconds"]}}},"required":["id","name","seconds","billableSeconds","days"]}},"outcomes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"completedAt":{"type":"string"},"result":{"type":"string"},"seconds":{"type":"number"}},"required":["id","title","projectId","projectName","completedAt","result","seconds"]}},"userId":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"taskId":{"type":"string","minLength":1,"maxLength":200},"projectId":{"type":"string","minLength":1,"maxLength":200},"taskTitle":{"type":"string"},"projectName":{"type":"string"},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]},"billable":{"type":"boolean"},"seconds":{"type":"number"}},"required":["id","taskId","projectId","taskTitle","projectName","startedAt","stoppedAt","billable","seconds"]}}},"required":["week","endsOn","version","timezone","sampledAt","seconds","billableSeconds","days","review","hasRunning","hasOtherReviewer","projects","outcomes","userId","name","entries"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/reviews/{userId}/{week}/approve":{"post":{"operationId":"approveReview","summary":"approve a team member's week","description":"approve a team member's week\nRequired application permissions: reviews:team:read, reviews:team:write. Requires an organization-wide key.","tags":["reviews"],"security":[{"bearerAuth":[]}],"x-required-scopes":["reviews:team:read","reviews:team:write"],"x-project-access":false,"parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"week","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"comment":{"default":"","type":"string","maxLength":2000}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"week":{"type":"string"},"endsOn":{"type":"string"},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"sampledAt":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"locked":{"type":"boolean"}},"required":["date","seconds","billableSeconds","locked"]}},"review":{"type":"object","properties":{"status":{"type":"string","enum":["draft","submitted","returned","approved"]},"comment":{"type":"string"},"submittedAt":{"type":["string","null"]},"reviewedAt":{"type":["string","null"]},"reviewerName":{"type":["string","null"]}},"required":["status","comment","submittedAt","reviewedAt","reviewerName"]},"hasRunning":{"type":"boolean"},"hasOtherReviewer":{"type":"boolean"},"projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"}},"required":["date","seconds","billableSeconds"]}}},"required":["id","name","seconds","billableSeconds","days"]}},"outcomes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"completedAt":{"type":"string"},"result":{"type":"string"},"seconds":{"type":"number"}},"required":["id","title","projectId","projectName","completedAt","result","seconds"]}},"userId":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"taskId":{"type":"string","minLength":1,"maxLength":200},"projectId":{"type":"string","minLength":1,"maxLength":200},"taskTitle":{"type":"string"},"projectName":{"type":"string"},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]},"billable":{"type":"boolean"},"seconds":{"type":"number"}},"required":["id","taskId","projectId","taskTitle","projectName","startedAt","stoppedAt","billable","seconds"]}}},"required":["week","endsOn","version","timezone","sampledAt","seconds","billableSeconds","days","review","hasRunning","hasOtherReviewer","projects","outcomes","userId","name","entries"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/reviews/{userId}/{week}/return":{"post":{"operationId":"returnReview","summary":"return a team member's week","description":"return a team member's week\nRequired application permissions: reviews:team:read, reviews:team:write. Requires an organization-wide key.","tags":["reviews"],"security":[{"bearerAuth":[]}],"x-required-scopes":["reviews:team:read","reviews:team:write"],"x-project-access":false,"parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"week","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"comment":{"default":"","type":"string","maxLength":2000}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"week":{"type":"string"},"endsOn":{"type":"string"},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"sampledAt":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"locked":{"type":"boolean"}},"required":["date","seconds","billableSeconds","locked"]}},"review":{"type":"object","properties":{"status":{"type":"string","enum":["draft","submitted","returned","approved"]},"comment":{"type":"string"},"submittedAt":{"type":["string","null"]},"reviewedAt":{"type":["string","null"]},"reviewerName":{"type":["string","null"]}},"required":["status","comment","submittedAt","reviewedAt","reviewerName"]},"hasRunning":{"type":"boolean"},"hasOtherReviewer":{"type":"boolean"},"projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"}},"required":["date","seconds","billableSeconds"]}}},"required":["id","name","seconds","billableSeconds","days"]}},"outcomes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"completedAt":{"type":"string"},"result":{"type":"string"},"seconds":{"type":"number"}},"required":["id","title","projectId","projectName","completedAt","result","seconds"]}},"userId":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"taskId":{"type":"string","minLength":1,"maxLength":200},"projectId":{"type":"string","minLength":1,"maxLength":200},"taskTitle":{"type":"string"},"projectName":{"type":"string"},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]},"billable":{"type":"boolean"},"seconds":{"type":"number"}},"required":["id","taskId","projectId","taskTitle","projectName","startedAt","stoppedAt","billable","seconds"]}}},"required":["week","endsOn","version","timezone","sampledAt","seconds","billableSeconds","days","review","hasRunning","hasOtherReviewer","projects","outcomes","userId","name","entries"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/reviews/{userId}/{week}/reopen":{"post":{"operationId":"reopenReview","summary":"reopen a team member's week","description":"reopen a team member's week\nRequired application permissions: reviews:team:read, reviews:team:write. Requires an organization-wide key.","tags":["reviews"],"security":[{"bearerAuth":[]}],"x-required-scopes":["reviews:team:read","reviews:team:write"],"x-project-access":false,"parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"week","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"comment":{"default":"","type":"string","maxLength":2000}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"week":{"type":"string"},"endsOn":{"type":"string"},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"sampledAt":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"locked":{"type":"boolean"}},"required":["date","seconds","billableSeconds","locked"]}},"review":{"type":"object","properties":{"status":{"type":"string","enum":["draft","submitted","returned","approved"]},"comment":{"type":"string"},"submittedAt":{"type":["string","null"]},"reviewedAt":{"type":["string","null"]},"reviewerName":{"type":["string","null"]}},"required":["status","comment","submittedAt","reviewedAt","reviewerName"]},"hasRunning":{"type":"boolean"},"hasOtherReviewer":{"type":"boolean"},"projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"days":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"}},"required":["date","seconds","billableSeconds"]}}},"required":["id","name","seconds","billableSeconds","days"]}},"outcomes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"completedAt":{"type":"string"},"result":{"type":"string"},"seconds":{"type":"number"}},"required":["id","title","projectId","projectName","completedAt","result","seconds"]}},"userId":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"entries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"taskId":{"type":"string","minLength":1,"maxLength":200},"projectId":{"type":"string","minLength":1,"maxLength":200},"taskTitle":{"type":"string"},"projectName":{"type":"string"},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]},"billable":{"type":"boolean"},"seconds":{"type":"number"}},"required":["id","taskId","projectId","taskTitle","projectName","startedAt","stoppedAt","billable","seconds"]}}},"required":["week","endsOn","version","timezone","sampledAt","seconds","billableSeconds","days","review","hasRunning","hasOtherReviewer","projects","outcomes","userId","name","entries"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/reports":{"get":{"operationId":"getReport","summary":"Read a report without private work notes","description":"Read a report without private work notes\nRequired application permissions: reports:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["reports"],"security":[{"bearerAuth":[]}],"x-required-scopes":["reports:read"],"x-project-access":true,"parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"clientId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"projectId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"memberId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["activity","completed","time"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"orgId":{"type":"string","minLength":1,"maxLength":200},"admin":{"type":"boolean"},"timezone":{"type":"string"},"sampledAt":{"type":"string"},"filters":{"type":"object","properties":{"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"clientId":{"type":"string","minLength":1,"maxLength":200},"projectId":{"type":"string","minLength":1,"maxLength":200},"memberId":{"type":"string","minLength":1,"maxLength":200},"view":{"type":"string","enum":["activity","completed","time"]}}},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"runningSeconds":{"type":"number"},"reviewSeconds":{"type":"object","properties":{"draft":{"type":"number"},"submitted":{"type":"number"},"returned":{"type":"number"},"approved":{"type":"number"}},"required":["draft","submitted","returned","approved"]},"tasks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"projectArchived":{"type":"boolean"},"clientName":{"type":["string","null"]},"clientId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"status":{"type":"string","enum":["open","completed"]},"statusName":{"type":"string"},"assigneeId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeName":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"completedInPeriod":{"type":"boolean"},"hasTimeInPeriod":{"type":"boolean"},"result":{"type":"string"},"seconds":{"type":"number"},"billableSeconds":{"type":"number"},"reviewSeconds":{"type":"object","properties":{"draft":{"type":"number"},"submitted":{"type":"number"},"returned":{"type":"number"},"approved":{"type":"number"}},"required":["draft","submitted","returned","approved"]},"slices":{"type":"array","items":{"type":"object","properties":{"entryId":{"type":"string","minLength":1,"maxLength":200},"date":{"type":"string"},"week":{"type":"string"},"startedAt":{"type":"string"},"stoppedAt":{"type":["string","null"]},"sliceStart":{"type":"string"},"sliceEnd":{"type":"string"},"seconds":{"type":"number"},"userId":{"type":"string","minLength":1,"maxLength":200},"memberName":{"type":"string"},"clientId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"clientName":{"type":["string","null"]},"projectId":{"type":"string","minLength":1,"maxLength":200},"projectName":{"type":"string"},"taskId":{"type":"string","minLength":1,"maxLength":200},"taskTitle":{"type":"string"},"billable":{"type":"boolean"},"reviewStatus":{"type":"string","enum":["draft","submitted","returned","approved"]},"running":{"type":"boolean"}},"required":["entryId","date","week","startedAt","stoppedAt","sliceStart","sliceEnd","seconds","userId","memberName","clientId","clientName","projectId","projectName","taskId","taskTitle","billable","reviewStatus","running"]}}},"required":["id","title","projectId","projectName","projectArchived","clientName","clientId","status","statusName","assigneeId","assigneeName","completedAt","completedInPeriod","hasTimeInPeriod","result","seconds","billableSeconds","reviewSeconds","slices"]}},"completedCount":{"type":"number"},"tasksWithTimeCount":{"type":"number"},"completedWithoutTimeCount":{"type":"number"},"undatedCompletedCount":{"type":"number"},"fingerprint":{"type":"string"}},"required":["orgId","admin","timezone","sampledAt","filters","seconds","billableSeconds","runningSeconds","reviewSeconds","tasks","completedCount","tasksWithTimeCount","completedWithoutTimeCount","undatedCompletedCount","fingerprint"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/reports/entries.csv":{"get":{"operationId":"exportEntriesCsv","summary":"Export a matching entries report snapshot","description":"Export a matching entries report snapshot\nRequired application permissions: reports:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["reports"],"security":[{"bearerAuth":[]}],"x-required-scopes":["reports:read"],"x-project-access":true,"parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"clientId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"projectId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"memberId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["activity","completed","time"]}},{"name":"sampledAt","in":"query","required":true,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"fingerprint","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-f\\d]{64}$"}}],"responses":{"200":{"description":"Success","content":{"text/csv":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string"}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/reports/tasks.csv":{"get":{"operationId":"exportTasksCsv","summary":"Export a matching tasks report snapshot","description":"Export a matching tasks report snapshot\nRequired application permissions: reports:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["reports"],"security":[{"bearerAuth":[]}],"x-required-scopes":["reports:read"],"x-project-access":true,"parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"clientId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"projectId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"memberId","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["activity","completed","time"]}},{"name":"sampledAt","in":"query","required":true,"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},{"name":"fingerprint","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-f\\d]{64}$"}}],"responses":{"200":{"description":"Success","content":{"text/csv":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string"}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/reports/client-summary":{"post":{"operationId":"createClientSummary","summary":"Generate a client summary without sending it","description":"Generate a client summary without sending it\nRequired application permissions: reports:read. Project keys are restricted to their selected project; assignment directory and shared workflow reads remain available when permitted.","tags":["reports"],"security":[{"bearerAuth":[]}],"x-required-scopes":["reports:read"],"x-project-access":true,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"clientId":{"type":"string","minLength":1,"maxLength":200},"projectId":{"type":"string","minLength":1,"maxLength":200},"memberId":{"type":"string","minLength":1,"maxLength":200},"view":{"type":"string","enum":["activity","completed","time"]},"sampledAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"fingerprint":{"type":"string","pattern":"^[a-f\\d]{64}$"},"taskIds":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"includeTime":{"default":false,"type":"boolean"}},"required":["sampledAt","fingerprint","taskIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"text":{"type":"string"},"count":{"type":"number"}},"required":["text","count"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/invitations":{"get":{"operationId":"listInvitations","summary":"Read organization invitations","description":"Read organization invitations\nRequired application permissions: members:read, team:write. Requires an organization-wide key.","tags":["invitations"],"security":[{"bearerAuth":[]}],"x-required-scopes":["members:read","team:write"],"x-project-access":false,"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":4000}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"email":{"type":"string"},"role":{"type":"string"},"status":{"type":"string"},"expiresAt":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","email","role","status","expiresAt","createdAt"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}},"required":["data","page"],"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"post":{"operationId":"createInvitation","summary":"Invite an admin or member","description":"Invite an admin or member\nRequired application permissions: members:read, team:write. Requires an organization-wide key.","tags":["invitations"],"security":[{"bearerAuth":[]}],"x-required-scopes":["members:read","team:write"],"x-project-access":false,"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"role":{"type":"string","enum":["admin","member"]}},"required":["email","role"],"additionalProperties":false}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"email":{"type":"string"},"role":{"type":"string"},"status":{"type":"string"},"expiresAt":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","email","role","status","expiresAt","createdAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/invitations/{id}/cancel":{"post":{"operationId":"cancelInvitation","summary":"Cancel a pending invitation","description":"Cancel a pending invitation\nRequired application permissions: members:read, team:write. Requires an organization-wide key.","tags":["invitations"],"security":[{"bearerAuth":[]}],"x-required-scopes":["members:read","team:write"],"x-project-access":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"email":{"type":"string"},"role":{"type":"string"},"status":{"type":"string"},"expiresAt":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","email","role","status","expiresAt","createdAt"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/invitations/{id}/send":{"post":{"operationId":"sendInvitation","summary":"Send an invitation through the configured email provider","description":"Send an invitation through the configured email provider\nRequired application permissions: members:read, team:write. Requires an organization-wide key.","tags":["invitations"],"security":[{"bearerAuth":[]}],"x-required-scopes":["members:read","team:write"],"x-project-access":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["accepted","failed","unknown"]}},"required":["status"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/members/{id}":{"patch":{"operationId":"updateMember","summary":"Change a non-owner member's role","description":"Change a non-owner member's role\nRequired application permissions: members:read, team:write. Requires an organization-wide key.","tags":["members"],"security":[{"bearerAuth":[]}],"x-required-scopes":["members:read","team:write"],"x-project-access":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"role":{"type":"string","enum":["admin","member"]}},"required":["expectedVersion","role"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"userId":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","userId","name","role","version"]}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}},"delete":{"operationId":"removeMember","summary":"Remove a non-owner member","description":"Remove a non-owner member\nRequired application permissions: members:read, team:write. Requires an organization-wide key.","tags":["members"],"security":[{"bearerAuth":[]}],"x-required-scopes":["members:read","team:write"],"x-project-access":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"expectedVersion","in":"query","required":true,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Deleted"},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}},"/members/{id}/reassign-tasks":{"post":{"operationId":"reassignMemberTasks","summary":"Atomically reassign selected tasks from a member","description":"Atomically reassign selected tasks from a member\nRequired application permissions: members:read, team:write, tasks:read, tasks:write. Requires an organization-wide key.","tags":["members"],"security":[{"bearerAuth":[]}],"x-required-scopes":["members:read","team:write","tasks:read","tasks:write"],"x-project-access":false,"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"assigneeId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"tasks":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","expectedVersion"],"additionalProperties":false}}},"required":["assigneeId","tasks"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"title":{"type":"string"},"description":{"type":"string"},"projectId":{"type":"string","minLength":1,"maxLength":200},"assigneeId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentKeyId":{"anyOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"null"}]},"assigneeAgentName":{"type":["string","null"]},"dueOn":{"type":["string","null"]},"statusId":{"type":"string","minLength":1,"maxLength":200},"statusCategory":{"type":"string","enum":["not_started","in_progress","completed"]},"result":{"type":"string"},"completedAt":{"type":["string","null"]},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"boardRank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200},"name":{"type":"string"}},"required":["id","name"]}}},"required":["id","title","description","projectId","assigneeId","assigneeAgentKeyId","assigneeAgentName","dueOn","statusId","statusCategory","result","completedAt","version","createdAt","boardRank","tags"]}}},"required":["data"]}}}},"400":{"description":"Invalid request/cursor or missing idempotency key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"401":{"description":"Invalid, expired, or revoked API key","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"403":{"description":"Insufficient scope or session-only ownership operation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"404":{"description":"Resource unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"405":{"description":"Method not allowed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"409":{"description":"Stale version, reused idempotency key, or domain conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"413":{"description":"Body exceeds 64 KiB","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"415":{"description":"Send application/json","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"422":{"description":"Schema or domain validation failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"429":{"description":"Rate limited; observe Retry-After","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}},"500":{"description":"Internal error; preserve idempotency key when retrying","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}}}}}}}}}