{"openapi":"3.1.0","info":{"title":"Heirlo Integration Sandbox","version":"1.1.0","description":"FICTIONAL DATA ONLY. Use a sandbox key. No communications or provider calls. Firm-scoped core records. Create and edit contacts, matters, tasks, and notes. Contacts are existing client accounts, not prospects or related parties. Writes do not trigger automations, notifications, outreach, estate setup, or billing. No delete, files, webhooks, OAuth, or automatic synchronization in v1. Rate limits: 120 requests per minute per key, 600 per firm, and 300 per source IP (IPv6 /64), shared across workers. Up to 4 concurrent requests per key and 12 per firm. JSON bodies are limited to 32 KiB; compressed bodies are not accepted. RateLimit-Limit/Remaining/Reset describe the key budget on authenticated requests; Retry-After is seconds. X-Request-ID identifies requests for support. Errors preserve the error message and add code, requestId, and optional field details. POST and PATCH require a UUID Idempotency-Key; reuse it only for an identical retry. PATCH requires the latest updatedAt and at least one changed field. Idempotent responses are retained while a key is usable, then become eligible for deletion 30 days after revocation or expiration. Existing usable keys retain their lifetime replay guarantee. Request metadata is retained for 90 days. Use UTC timestamps. Pagination is ordered by ID and is not a snapshot; for incremental polling use an overlapping updatedSince window and deduplicate by ID/updatedAt. API scopes do not grant access to legacy staff endpoints."},"servers":[{"url":"/api/v1"}],"security":[{"IntegrationKey":[]}],"components":{"securitySchemes":{"IntegrationKey":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"Contacts":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"owner":{"type":["string","null"]},"status":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"firstName":{"type":["string","null"]},"lastName":{"type":["string","null"]},"email":{"type":["string","null"]},"phone":{"type":["string","null"]}},"required":["id","owner","status","createdAt","updatedAt","firstName","lastName","email","phone"]},"ContactsCreate":{"type":"object","additionalProperties":false,"properties":{"firstName":{"type":"string","minLength":1,"maxLength":200},"lastName":{"type":"string","minLength":1,"maxLength":200},"email":{"type":"string","format":"email","maxLength":254},"phone":{"type":"string","maxLength":100},"owner":{"type":"string","maxLength":200}},"required":["firstName","lastName"]},"ContactsPatch":{"type":"object","additionalProperties":false,"properties":{"firstName":{"type":"string","minLength":1,"maxLength":200},"lastName":{"type":"string","minLength":1,"maxLength":200},"email":{"type":"string","format":"email","maxLength":254},"phone":{"type":"string","maxLength":100},"owner":{"type":"string","maxLength":200},"updatedAt":{"type":"string","format":"date-time"}},"required":["updatedAt"],"minProperties":2},"Matters":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"clientId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"practiceArea":{"type":["string","null"]},"stage":{"type":["string","null"]},"owner":{"type":["string","null"]},"venue":{"type":["string","null"]},"openedAt":{"type":"string","format":"date-time"},"closedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","clientId","title","description","practiceArea","stage","owner","venue","openedAt","closedAt","createdAt","updatedAt"]},"MattersCreate":{"type":"object","additionalProperties":false,"properties":{"clientId":{"type":"string","format":"uuid"},"title":{"type":"string","minLength":1,"maxLength":300},"description":{"type":"string","maxLength":5000},"practiceArea":{"type":"string","maxLength":200},"owner":{"type":"string","maxLength":200},"venue":{"type":"string","maxLength":300}},"required":["clientId","title"]},"MattersPatch":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","minLength":1,"maxLength":300},"description":{"type":"string","maxLength":5000},"practiceArea":{"type":"string","maxLength":200},"owner":{"type":"string","maxLength":200},"venue":{"type":"string","maxLength":300},"updatedAt":{"type":"string","format":"date-time"}},"required":["updatedAt"],"minProperties":2},"Tasks":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"clientId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"matterId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"status":{"type":["string","null"]},"priority":{"type":["string","null"]},"dueAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"revision":{"type":"integer"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","clientId","matterId","title","description","status","priority","dueAt","revision","createdAt","updatedAt"]},"TasksCreate":{"type":"object","additionalProperties":false,"properties":{"clientId":{"type":"string","format":"uuid"},"matterId":{"type":"string","format":"uuid"},"title":{"type":"string","minLength":1,"maxLength":300},"description":{"type":"string","maxLength":5000},"dueAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"priority":{"type":"string","enum":["low","medium","high"]},"status":{"type":"string","enum":["open","in_progress","completed","cancelled"]}},"required":["title"]},"TasksPatch":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","minLength":1,"maxLength":300},"description":{"type":"string","maxLength":5000},"dueAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"priority":{"type":"string","enum":["low","medium","high"]},"status":{"type":"string","enum":["open","in_progress","completed","cancelled"]},"updatedAt":{"type":"string","format":"date-time"}},"required":["updatedAt"],"minProperties":2},"Notes":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"clientId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"matterId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"body":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","clientId","matterId","body","createdAt","updatedAt"]},"NotesCreate":{"type":"object","additionalProperties":false,"properties":{"clientId":{"type":"string","format":"uuid"},"matterId":{"type":"string","format":"uuid"},"body":{"type":"string","minLength":1,"maxLength":20000}},"required":["body"],"anyOf":[{"required":["clientId"]},{"required":["matterId"]}]},"NotesPatch":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"string","minLength":1,"maxLength":20000},"updatedAt":{"type":"string","format":"date-time"}},"required":["updatedAt"],"minProperties":2}}},"paths":{"/contacts":{"get":{"operationId":"listContacts","tags":["contacts"],"description":"List records. Required scope: v1:contacts:read.","parameters":[{"name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query"},{"name":"after","schema":{"type":"string","format":"uuid"},"in":"query"},{"name":"updatedSince","schema":{"type":"string","format":"date-time"},"in":"query"}],"responses":{"200":{"description":"A page of records","content":{"application/json":{"schema":{"type":"object","required":["data","pagination"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Contacts"}},"pagination":{"type":"object","required":["hasMore","nextCursor"],"properties":{"hasMore":{"type":"boolean"},"nextCursor":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]}}}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}},"post":{"operationId":"createContacts","tags":["contacts"],"description":"Create a record. Required scope: v1:contacts:write.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactsCreate"}}}},"responses":{"201":{"description":"Saved record (or original response on retry)","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Contacts"}}}}},"headers":{"Idempotency-Replayed":{"schema":{"type":"string","enum":["true","false"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}}},"/contacts/{id}":{"get":{"operationId":"getContacts","tags":["contacts"],"description":"Get one record. Required scope: v1:contacts:read.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Record","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Contacts"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}},"patch":{"operationId":"updateContacts","tags":["contacts"],"description":"Update a record. Calendar events cannot be edited through the tasks API. Required scope: v1:contacts:write.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactsPatch"}}}},"responses":{"200":{"description":"Saved record (or original response on retry)","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Contacts"}}}}},"headers":{"Idempotency-Replayed":{"schema":{"type":"string","enum":["true","false"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}}},"/matters":{"get":{"operationId":"listMatters","tags":["matters"],"description":"List records. Required scope: v1:matters:read.","parameters":[{"name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query"},{"name":"after","schema":{"type":"string","format":"uuid"},"in":"query"},{"name":"updatedSince","schema":{"type":"string","format":"date-time"},"in":"query"},{"name":"clientId","schema":{"type":"string","format":"uuid"},"in":"query"}],"responses":{"200":{"description":"A page of records","content":{"application/json":{"schema":{"type":"object","required":["data","pagination"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Matters"}},"pagination":{"type":"object","required":["hasMore","nextCursor"],"properties":{"hasMore":{"type":"boolean"},"nextCursor":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]}}}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}},"post":{"operationId":"createMatters","tags":["matters"],"description":"Create a record. Required scope: v1:matters:write.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MattersCreate"}}}},"responses":{"201":{"description":"Saved record (or original response on retry)","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Matters"}}}}},"headers":{"Idempotency-Replayed":{"schema":{"type":"string","enum":["true","false"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}}},"/matters/{id}":{"get":{"operationId":"getMatters","tags":["matters"],"description":"Get one record. Required scope: v1:matters:read.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Record","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Matters"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}},"patch":{"operationId":"updateMatters","tags":["matters"],"description":"Update a record. Calendar events cannot be edited through the tasks API. Required scope: v1:matters:write.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MattersPatch"}}}},"responses":{"200":{"description":"Saved record (or original response on retry)","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Matters"}}}}},"headers":{"Idempotency-Replayed":{"schema":{"type":"string","enum":["true","false"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}}},"/tasks":{"get":{"operationId":"listTasks","tags":["tasks"],"description":"List records. Required scope: v1:tasks:read.","parameters":[{"name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query"},{"name":"after","schema":{"type":"string","format":"uuid"},"in":"query"},{"name":"updatedSince","schema":{"type":"string","format":"date-time"},"in":"query"},{"name":"clientId","schema":{"type":"string","format":"uuid"},"in":"query"},{"name":"matterId","schema":{"type":"string","format":"uuid"},"in":"query"}],"responses":{"200":{"description":"A page of records","content":{"application/json":{"schema":{"type":"object","required":["data","pagination"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Tasks"}},"pagination":{"type":"object","required":["hasMore","nextCursor"],"properties":{"hasMore":{"type":"boolean"},"nextCursor":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]}}}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}},"post":{"operationId":"createTasks","tags":["tasks"],"description":"Create a record. Required scope: v1:tasks:write.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TasksCreate"}}}},"responses":{"201":{"description":"Saved record (or original response on retry)","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Tasks"}}}}},"headers":{"Idempotency-Replayed":{"schema":{"type":"string","enum":["true","false"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}}},"/tasks/{id}":{"get":{"operationId":"getTasks","tags":["tasks"],"description":"Get one record. Required scope: v1:tasks:read.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Record","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Tasks"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}},"patch":{"operationId":"updateTasks","tags":["tasks"],"description":"Update a record. Calendar events cannot be edited through the tasks API. Required scope: v1:tasks:write.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TasksPatch"}}}},"responses":{"200":{"description":"Saved record (or original response on retry)","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Tasks"}}}}},"headers":{"Idempotency-Replayed":{"schema":{"type":"string","enum":["true","false"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}}},"/notes":{"get":{"operationId":"listNotes","tags":["notes"],"description":"List records. Required scope: v1:notes:read.","parameters":[{"name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query"},{"name":"after","schema":{"type":"string","format":"uuid"},"in":"query"},{"name":"updatedSince","schema":{"type":"string","format":"date-time"},"in":"query"},{"name":"clientId","schema":{"type":"string","format":"uuid"},"in":"query"},{"name":"matterId","schema":{"type":"string","format":"uuid"},"in":"query"}],"responses":{"200":{"description":"A page of records","content":{"application/json":{"schema":{"type":"object","required":["data","pagination"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Notes"}},"pagination":{"type":"object","required":["hasMore","nextCursor"],"properties":{"hasMore":{"type":"boolean"},"nextCursor":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]}}}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}},"post":{"operationId":"createNotes","tags":["notes"],"description":"Create a record. Required scope: v1:notes:write.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotesCreate"}}}},"responses":{"201":{"description":"Saved record (or original response on retry)","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Notes"}}}}},"headers":{"Idempotency-Replayed":{"schema":{"type":"string","enum":["true","false"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}}},"/notes/{id}":{"get":{"operationId":"getNotes","tags":["notes"],"description":"Get one record. Required scope: v1:notes:read.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Record","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Notes"}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}},"patch":{"operationId":"updateNotes","tags":["notes"],"description":"Update a record. Calendar events cannot be edited through the tasks API. Required scope: v1:notes:write.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotesPatch"}}}},"responses":{"200":{"description":"Saved record (or original response on retry)","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/Notes"}}}}},"headers":{"Idempotency-Replayed":{"schema":{"type":"string","enum":["true","false"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Invalid or expired credential","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Permission or firm access denied","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Version conflict or idempotency conflict","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"413":{"description":"Request exceeds 32 KiB","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Unsupported encoding","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","requestId"],"properties":{"error":{"type":"string"},"code":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retrying"}}}}}}}}