{"openapi":"3.1.0","info":{"title":"MeetYourAgent API","version":"1.0.0","description":"REST API v1. Errors: {error:{code, message, details, request_id}}. Lists are cursor-paginated (limit, cursor → next_cursor). POST requests accept an Idempotency-Key header. API keys are rate-limited per key (X-RateLimit-* headers; 429 rate_limited with Retry-After)."},"servers":[{"url":"/api/v1"}],"tags":[{"name":"Catalog"},{"name":"Billing"},{"name":"Platform"},{"name":"Hiring"},{"name":"Contracts"},{"name":"Connections"},{"name":"Workspace"},{"name":"AI"},{"name":"Colleagues"},{"name":"Requests"},{"name":"Org"},{"name":"Approvals"},{"name":"Webhooks"},{"name":"Support"},{"name":"Hub"}],"paths":{"/agents":{"get":{"operationId":"listAgents","tags":["Catalog"],"summary":"Published agents in the catalog","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{slug}":{"get":{"operationId":"getAgent","tags":["Catalog"],"summary":"One agent's public profile","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/agents/{slug}/interview":{"post":{"operationId":"interviewAgent","tags":["Catalog"],"summary":"Interview an agent (streamed reply)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"messages":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"role":{"type":"string","enum":["user","assistant"]},"text":{"type":"string","minLength":1,"maxLength":2000}},"required":["role","text"],"additionalProperties":false}},"locale":{"default":"en","type":"string","enum":["en","fr"]}},"required":["messages"],"additionalProperties":false}}}},"responses":{"200":{"description":"Stream","content":{"text/event-stream":{"schema":{"type":"string"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/plans":{"get":{"operationId":"listPlans","tags":["Billing"],"summary":"Plans with their limits and features","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"plans":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"price_cents":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"limits":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"features":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["key","name","price_cents","limits","features"]}}},"required":["plans"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/verify/{certId}":{"get":{"operationId":"verifyCertificate","tags":["Platform"],"summary":"Check a Deletion Certificate's signature","security":[],"parameters":[{"name":"certId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/changelog":{"get":{"operationId":"listChangelog","tags":["Platform"],"summary":"Published changelog entries","security":[],"parameters":[{"name":"locale","in":"query","required":false,"description":"en or fr","schema":{"type":"string","enum":["en","fr"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/security/reports":{"post":{"operationId":"reportVulnerability","tags":["Platform"],"summary":"Report a security vulnerability","security":[],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","maxLength":200,"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,}$"},"title":{"type":"string","minLength":3,"maxLength":200},"details":{"type":"string","minLength":20,"maxLength":20000},"turnstile_token":{"type":"string","minLength":1,"maxLength":4096}},"required":["email","title","details"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/status":{"get":{"operationId":"getStatus","tags":["Platform"],"summary":"Component status, incident history and daily audit anchors","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"overall":{"type":"string","enum":["operational","maintenance","minor","major","critical"]},"components":{"type":"object","propertyNames":{"type":"string","enum":["web","api","agents","vault","billing","notifications"]},"additionalProperties":{"type":"string","enum":["operational","maintenance","minor","major","critical"]},"required":["web","api","agents","vault","billing","notifications"]},"incidents":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"title":{"type":"string"},"impact":{"type":"string","enum":["maintenance","minor","major","critical"]},"status":{"type":"string","enum":["investigating","identified","monitoring","resolved"]},"components":{"type":"array","items":{"type":"string","enum":["web","api","agents","vault","billing","notifications"]}},"started_at":{"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)))$"},"resolved_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"updates":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","enum":["investigating","identified","monitoring","resolved"]},"body":{"type":"string"},"created_at":{"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)))$"}},"required":["status","body","created_at"]}}},"required":["id","title","impact","status","components","started_at","resolved_at","updates"]}},"anchors":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string","format":"date","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])))$"},"digest":{"type":"string"},"chains":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"published_at":{"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)))$"}},"required":["day","digest","chains","published_at"]}}},"required":["overall","components","incidents","anchors"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/status/anchors/{day}":{"get":{"operationId":"getAnchorDay","tags":["Platform"],"summary":"One day's audit anchor with its leaves","security":[],"parameters":[{"name":"day","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"day":{"type":"string","format":"date","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])))$"},"digest":{"type":"string"},"chains":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"leaves":{"type":"array","items":{"type":"string"}},"published_at":{"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)))$"}},"required":["day","digest","chains","leaves","published_at"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/legal":{"get":{"operationId":"listLegalDocuments","tags":["Platform"],"summary":"Legal documents with their current version and hash","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/legal/{key}":{"get":{"operationId":"getLegalDocument","tags":["Platform"],"summary":"One legal document (en or fr)","security":[],"parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"query","required":false,"description":"en or fr","schema":{"type":"string","enum":["en","fr"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/openapi.json":{"get":{"operationId":"getOpenApi","tags":["Platform"],"summary":"This document","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/contracts/drafts/{id}/checkout":{"post":{"operationId":"checkoutDraft","tags":["Hiring"],"summary":"Complete a hire: accept the terms and pay","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accept_terms":{"type":"boolean","const":true}},"required":["accept_terms"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/billing/checkout":{"post":{"operationId":"checkoutPlan","tags":["Billing"],"summary":"Subscribe the organization to a plan","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"plan_key":{"type":"string","maxLength":40,"pattern":"^[a-z0-9_]+$"},"org_id":{"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":["plan_key","org_id"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/billing/subscription":{"get":{"operationId":"getSubscription","tags":["Billing"],"summary":"The organization's subscriptions","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/contracts":{"get":{"operationId":"listContracts","tags":["Contracts"],"summary":"Contracts you can see","description":"API key scope: `contracts:read`. Cursor-paginated.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"limit","in":"query","required":false,"description":"Items per page, 1 to 100 (default 25).","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor of the previous page.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"contracts":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"title":{"type":"string"},"type":{"type":"string","enum":["fixed","task","retainer","trial"]},"status":{"type":"string"},"agent_slug":{"type":["string","null"]},"autonomy":{"type":"string","enum":["L0","L1","L2"]},"starts_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"ends_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"included_wu":{"type":["number","null"]},"wu_used":{"type":"number"},"deletion_certificate_id":{"anyOf":[{"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)$"},{"type":"null"}]},"created_at":{"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)))$"}},"required":["id","title","type","status","agent_slug","autonomy","starts_at","ends_at","included_wu","wu_used","deletion_certificate_id","created_at"]}},"next_cursor":{"type":["string","null"]}},"required":["contracts","next_cursor"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"contracts:read"}},"/contracts/{id}":{"get":{"operationId":"getContract","tags":["Contracts"],"summary":"One contract","description":"API key scope: `contracts:read`.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"contract":{"type":"object","properties":{"id":{"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)$"},"title":{"type":"string"},"type":{"type":"string","enum":["fixed","task","retainer","trial"]},"status":{"type":"string"},"agent_slug":{"type":["string","null"]},"autonomy":{"type":"string","enum":["L0","L1","L2"]},"starts_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"ends_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"included_wu":{"type":["number","null"]},"wu_used":{"type":"number"},"deletion_certificate_id":{"anyOf":[{"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)$"},{"type":"null"}]},"created_at":{"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)))$"}},"required":["id","title","type","status","agent_slug","autonomy","starts_at","ends_at","included_wu","wu_used","deletion_certificate_id","created_at"]}},"required":["contract"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"contracts:read"}},"/contracts/{id}/end":{"post":{"operationId":"endContract","tags":["Contracts"],"summary":"End a contract and start offboarding","description":"Signed-in session only. Needs a recent sign-in (step-up).","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/contracts/{id}/activity":{"get":{"operationId":"getActivity","tags":["Contracts"],"summary":"Lifecycle events, sessions and tasks","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/contracts/{id}/reports":{"get":{"operationId":"listReports","tags":["Contracts"],"summary":"Reports, newest first","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"generateReport","tags":["Contracts"],"summary":"Write or refresh a period's report","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"period_start":{"type":"string","format":"date","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])))$"},"period_end":{"type":"string","format":"date","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])))$"}},"required":["period_start","period_end"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/contracts/{id}/connections":{"get":{"operationId":"listConnections","tags":["Connections"],"summary":"A contract's connections","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"connections":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"contract_id":{"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)$"},"provider":{"type":"string"},"method":{"type":"string","enum":["partner","oauth","handoff","api_key","vaulted"]},"display_name":{"type":"string"},"external_ids":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"scopes":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["pending","verifying","connected","expiring","revoked","failed"]},"expires_at":{"type":["string","null"]},"last_used_at":{"type":["string","null"]},"last_verified_at":{"type":["string","null"]},"revoked_at":{"type":["string","null"]},"revoke_confirmed_by_provider":{"type":"boolean"},"created_at":{"type":"string"}},"required":["id","contract_id","provider","method","display_name","external_ids","scopes","status","expires_at","last_used_at","last_verified_at","revoked_at","revoke_confirmed_by_provider","created_at"]}}},"required":["connections"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createConnection","tags":["Connections"],"summary":"Add a connection","description":"Signed-in session only. Needs a recent sign-in (step-up).","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":64},"method":{"type":"string","enum":["partner","oauth","handoff","api_key","vaulted"]},"display_name":{"type":"string","minLength":1,"maxLength":120},"scopes":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"external_ids":{"default":{},"type":"object","propertyNames":{"type":"string","maxLength":64},"additionalProperties":{"type":"string","maxLength":256}},"secret":{"type":"string","minLength":8,"maxLength":8192}},"required":["provider","method","display_name"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/connections/{id}":{"delete":{"operationId":"revokeConnection","tags":["Connections"],"summary":"Revoke a connection","description":"Signed-in session only. Needs a recent sign-in (step-up).","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/contracts/{id}/messages":{"get":{"operationId":"listMessages","tags":["Workspace"],"summary":"Chat messages","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"postMessage","tags":["Workspace"],"summary":"Send a chat message","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":4000}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/contracts/{id}/stream":{"get":{"operationId":"streamContract","tags":["Workspace"],"summary":"Live task events as server-sent events (v3 §6.3)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/contracts/{id}/tasks":{"post":{"operationId":"createTask","tags":["Workspace"],"summary":"Create a task","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":4000},"assignee":{"default":"agent","type":"string","enum":["agent","user"]},"due_at":{"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)))$"}},"required":["title"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/tasks/{id}":{"patch":{"operationId":"updateTask","tags":["Workspace"],"summary":"Move a task","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["todo","in_progress","review","done","cancelled"]}},"required":["status"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/routines/{id}/run":{"post":{"operationId":"runRoutine","tags":["Workspace"],"summary":"Run a routine now","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/ai/connections":{"get":{"operationId":"listAiConnections","tags":["AI"],"summary":"The org's and your AI connections (metadata only)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"connections":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"owner_scope":{"type":"string","enum":["org","user"]},"provider":{"type":"string"},"provider_name":{"type":"string"},"method":{"type":"string","enum":["api_key","openrouter_pkce"]},"status":{"type":"string","enum":["configured","verified","failed","revoked"]},"display_name":{"type":["string","null"]},"billing_owner":{"type":"string","enum":["org","user"]},"last_test_at":{"type":["string","null"]},"last_error":{"type":["string","null"]},"data_processing_terms_url":{"type":["string","null"]},"region":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","owner_scope","provider","provider_name","method","status","display_name","billing_owner","last_test_at","last_error","data_processing_terms_url","region","created_at"]}},"user_byok_allowed":{"type":"boolean"},"platform_available":{"type":"boolean"}},"required":["connections","user_byok_allowed","platform_available"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createAiConnection","tags":["AI"],"summary":"Connect an API key (stored in the vault, then tested)","description":"Signed-in session only. Needs a recent sign-in (step-up).","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scope":{"type":"string","enum":["org","user"]},"provider":{"type":"string","enum":["anthropic","openrouter"]},"api_key":{"type":"string","minLength":16,"maxLength":400},"display_name":{"type":"string","minLength":1,"maxLength":100}},"required":["scope","provider","api_key"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"connection":{"type":"object","properties":{"id":{"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)$"},"owner_scope":{"type":"string","enum":["org","user"]},"provider":{"type":"string"},"provider_name":{"type":"string"},"method":{"type":"string","enum":["api_key","openrouter_pkce"]},"status":{"type":"string","enum":["configured","verified","failed","revoked"]},"display_name":{"type":["string","null"]},"billing_owner":{"type":"string","enum":["org","user"]},"last_test_at":{"type":["string","null"]},"last_error":{"type":["string","null"]},"data_processing_terms_url":{"type":["string","null"]},"region":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","owner_scope","provider","provider_name","method","status","display_name","billing_owner","last_test_at","last_error","data_processing_terms_url","region","created_at"]},"ok":{"type":"boolean"},"error":{"type":["string","null"]}},"required":["connection","ok","error"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/ai/connections/{id}/test":{"post":{"operationId":"testAiConnection","tags":["AI"],"summary":"Test an AI connection","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"connection":{"type":"object","properties":{"id":{"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)$"},"owner_scope":{"type":"string","enum":["org","user"]},"provider":{"type":"string"},"provider_name":{"type":"string"},"method":{"type":"string","enum":["api_key","openrouter_pkce"]},"status":{"type":"string","enum":["configured","verified","failed","revoked"]},"display_name":{"type":["string","null"]},"billing_owner":{"type":"string","enum":["org","user"]},"last_test_at":{"type":["string","null"]},"last_error":{"type":["string","null"]},"data_processing_terms_url":{"type":["string","null"]},"region":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","owner_scope","provider","provider_name","method","status","display_name","billing_owner","last_test_at","last_error","data_processing_terms_url","region","created_at"]},"ok":{"type":"boolean"},"error":{"type":["string","null"]}},"required":["connection","ok","error"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/ai/connections/{id}":{"delete":{"operationId":"deleteAiConnection","tags":["AI"],"summary":"Disconnect and destroy the key","description":"Signed-in session only. Needs a recent sign-in (step-up).","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/ai/openrouter/start":{"get":{"operationId":"startOpenRouter","tags":["AI"],"summary":"Start connecting OpenRouter (OAuth PKCE)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"scope","in":"query","required":false,"description":"org or user","schema":{"type":"string","enum":["org","user"]}},{"name":"return_to","in":"query","required":false,"description":"Where to come back","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/ai/openrouter/callback":{"get":{"operationId":"finishOpenRouter","tags":["AI"],"summary":"Finish connecting OpenRouter","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"code","in":"query","required":false,"description":"From OpenRouter","schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"From /start","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sessions/{id}/cancel":{"post":{"operationId":"cancelSession","tags":["Workspace"],"summary":"Stop a running task (v3 §3.7)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"session_id":{"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)$"},"stop_requested":{"type":"boolean"},"status":{"type":"string","enum":["queued","running","closing","completed","failed","aborted"]}},"required":["session_id","stop_requested","status"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/colleagues":{"get":{"operationId":"listColleagues","tags":["Colleagues"],"summary":"Your colleagues and the team colleagues you work with","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"colleagues":{"type":"array","items":{"type":"object","properties":{"id":{"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":{"type":"string","enum":["personal","team"]},"name":{"type":"string"},"display_name":{"type":["string","null"]},"agent":{"type":"object","properties":{"id":{"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)$"},"slug":{"type":"string"},"name":{"type":"string"},"tagline":{"type":["string","null"]}},"required":["id","slug","name","tagline"]},"status":{"type":"string","enum":["active","paused","suspended","ended"]},"suspended_reason":{"type":["string","null"]},"autonomy":{"type":"string","enum":["L0","L1","L2"]},"can_manage":{"type":"boolean"},"last_activity_at":{"type":["string","null"]},"cost_this_month_wu":{"type":"number"},"created_at":{"type":"string"}},"required":["id","kind","name","display_name","agent","status","suspended_reason","autonomy","can_manage","last_activity_at","cost_this_month_wu","created_at"]}},"personal_remaining":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["colleagues","personal_remaining"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createColleague","tags":["Colleagues"],"summary":"Add a personal colleague from a hireable agent","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agent_id":{"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)$"},"agent_slug":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?$"},"display_name":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"colleague":{"type":"object","properties":{"id":{"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":{"type":"string","enum":["personal","team"]},"name":{"type":"string"},"display_name":{"type":["string","null"]},"agent":{"type":"object","properties":{"id":{"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)$"},"slug":{"type":"string"},"name":{"type":"string"},"tagline":{"type":["string","null"]}},"required":["id","slug","name","tagline"]},"status":{"type":"string","enum":["active","paused","suspended","ended"]},"suspended_reason":{"type":["string","null"]},"autonomy":{"type":"string","enum":["L0","L1","L2"]},"can_manage":{"type":"boolean"},"last_activity_at":{"type":["string","null"]},"cost_this_month_wu":{"type":"number"},"created_at":{"type":"string"}},"required":["id","kind","name","display_name","agent","status","suspended_reason","autonomy","can_manage","last_activity_at","cost_this_month_wu","created_at"]}},"required":["colleague"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/colleagues/{id}":{"get":{"operationId":"getColleague","tags":["Colleagues"],"summary":"A colleague, its instructions and the budget that applies","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"colleague":{"type":"object","properties":{"id":{"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":{"type":"string","enum":["personal","team"]},"name":{"type":"string"},"display_name":{"type":["string","null"]},"agent":{"type":"object","properties":{"id":{"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)$"},"slug":{"type":"string"},"name":{"type":"string"},"tagline":{"type":["string","null"]}},"required":["id","slug","name","tagline"]},"status":{"type":"string","enum":["active","paused","suspended","ended"]},"suspended_reason":{"type":["string","null"]},"autonomy":{"type":"string","enum":["L0","L1","L2"]},"can_manage":{"type":"boolean"},"last_activity_at":{"type":["string","null"]},"cost_this_month_wu":{"type":"number"},"created_at":{"type":"string"}},"required":["id","kind","name","display_name","agent","status","suspended_reason","autonomy","can_manage","last_activity_at","cost_this_month_wu","created_at"]},"instructions":{"anyOf":[{"type":"object","properties":{"version":{"type":"integer","minimum":1,"maximum":9007199254740991},"content":{"type":"string"},"created_at":{"type":"string"}},"required":["version","content","created_at"]},{"type":"null"}]},"budget":{"type":"object","properties":{"cap_wu":{"type":["number","null"]},"used_wu":{"type":"number"},"exhausted":{"type":"boolean"}},"required":["cap_wu","used_wu","exhausted"]}},"required":["colleague","instructions","budget"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"updateColleague","tags":["Colleagues"],"summary":"Rename, pause or resume a colleague","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}]},"status":{"type":"string","enum":["active","paused"]}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"colleague":{"type":"object","properties":{"id":{"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":{"type":"string","enum":["personal","team"]},"name":{"type":"string"},"display_name":{"type":["string","null"]},"agent":{"type":"object","properties":{"id":{"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)$"},"slug":{"type":"string"},"name":{"type":"string"},"tagline":{"type":["string","null"]}},"required":["id","slug","name","tagline"]},"status":{"type":"string","enum":["active","paused","suspended","ended"]},"suspended_reason":{"type":["string","null"]},"autonomy":{"type":"string","enum":["L0","L1","L2"]},"can_manage":{"type":"boolean"},"last_activity_at":{"type":["string","null"]},"cost_this_month_wu":{"type":"number"},"created_at":{"type":"string"}},"required":["id","kind","name","display_name","agent","status","suspended_reason","autonomy","can_manage","last_activity_at","cost_this_month_wu","created_at"]}},"required":["colleague"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"removeColleague","tags":["Colleagues"],"summary":"Remove a colleague (its memory is forgotten)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/colleagues/{id}/messages":{"get":{"operationId":"listColleagueMessages","tags":["Colleagues"],"summary":"A colleague's chat","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"messages":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"author":{"type":"string","enum":["user","agent","system"]},"content":{},"tool_calls":{},"session_id":{"anyOf":[{"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)$"},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","author","content","session_id","created_at"]}},"running_session_id":{"anyOf":[{"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)$"},{"type":"null"}]}},"required":["messages","running_session_id"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"postColleagueMessage","tags":["Colleagues"],"summary":"Ask a colleague something (queued)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":4000}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/colleagues/{id}/stream":{"get":{"operationId":"streamColleague","tags":["Colleagues"],"summary":"Live updates while a colleague works","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Stream","content":{"text/event-stream":{"schema":{"type":"string"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/colleagues/{id}/memories":{"get":{"operationId":"listColleagueMemories","tags":["Colleagues"],"summary":"What a colleague knows","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"memories":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"type":{"type":"string","enum":["fact","preference","decision","asset"]},"content":{"type":"string"},"pinned":{"type":"boolean"},"created_at":{"type":"string"}},"required":["id","type","content","pinned","created_at"]}}},"required":["memories"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/colleagues/{id}/memories/export":{"get":{"operationId":"exportColleagueMemories","tags":["Colleagues"],"summary":"Export what a colleague knows (JSON)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/colleagues/{id}/memories/{memoryId}":{"delete":{"operationId":"forgetColleagueMemory","tags":["Colleagues"],"summary":"Forget one thing a colleague knows","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"memoryId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/colleagues/{id}/instructions":{"put":{"operationId":"setColleagueInstructions","tags":["Colleagues"],"summary":"Give a colleague standing instructions (a new version)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","minLength":1,"maxLength":4000}},"required":["content"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"instructions":{"type":"object","properties":{"version":{"type":"integer","minimum":1,"maximum":9007199254740991},"content":{"type":"string"},"created_at":{"type":"string"}},"required":["version","content","created_at"]}},"required":["instructions"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/onboarding":{"get":{"operationId":"getOnboarding","tags":["Workspace"],"summary":"Your First Day: where you are, your guide, who powers your AI","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"step":{"type":"integer","minimum":0,"maximum":8},"skipped_steps":{"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"completed_at":{"type":["string","null"]},"guide":{"anyOf":[{"type":"object","properties":{"slug":{"type":"string"},"colleague_id":{"anyOf":[{"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)$"},{"type":"null"}]},"name":{"type":"string"}},"required":["slug","colleague_id","name"]},{"type":"null"}]},"answers":{"type":"object","properties":{"role":{"type":"string","enum":["content","messages","sales","business","other"]},"help_first":{"type":"string","maxLength":300},"language":{"type":"string","enum":["en","fr"]}},"additionalProperties":false},"guides":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"tagline":{"type":"string"}},"required":["slug","name","role","tagline"]}},"ai":{"type":"object","properties":{"source":{"type":"string","enum":["org","user","platform","none"]},"provider_name":{"type":["string","null"]},"org_name":{"type":"string"},"can_manage":{"type":"boolean"}},"required":["source","provider_name","org_name","can_manage"]}},"required":["step","skipped_steps","completed_at","guide","answers","guides","ai"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"startOnboarding","tags":["Workspace"],"summary":"Choose who onboards you (your first colleague)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"guide_agent_slug":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?$"}},"required":["guide_agent_slug"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"step":{"type":"integer","minimum":0,"maximum":8},"skipped_steps":{"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"completed_at":{"type":["string","null"]},"guide":{"anyOf":[{"type":"object","properties":{"slug":{"type":"string"},"colleague_id":{"anyOf":[{"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)$"},{"type":"null"}]},"name":{"type":"string"}},"required":["slug","colleague_id","name"]},{"type":"null"}]},"answers":{"type":"object","properties":{"role":{"type":"string","enum":["content","messages","sales","business","other"]},"help_first":{"type":"string","maxLength":300},"language":{"type":"string","enum":["en","fr"]}},"additionalProperties":false},"guides":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"tagline":{"type":"string"}},"required":["slug","name","role","tagline"]}},"ai":{"type":"object","properties":{"source":{"type":"string","enum":["org","user","platform","none"]},"provider_name":{"type":["string","null"]},"org_name":{"type":"string"},"can_manage":{"type":"boolean"}},"required":["source","provider_name","org_name","can_manage"]}},"required":["step","skipped_steps","completed_at","guide","answers","guides","ai"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/onboarding/step/{n}":{"patch":{"operationId":"updateOnboardingStep","tags":["Workspace"],"summary":"Finish or skip a First Day step","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"n","in":"path","required":true,"schema":{"type":"string"}},{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["done","skip"]},"answers":{"type":"object","properties":{"role":{"type":"string","enum":["content","messages","sales","business","other"]},"help_first":{"type":"string","maxLength":300},"language":{"type":"string","enum":["en","fr"]}},"additionalProperties":false}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/sources":{"get":{"operationId":"listSources","tags":["Workspace"],"summary":"What you gave your colleagues, and how each may be used","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"type":{"type":"string"},"display_name":{"type":"string"},"created_at":{"type":"string"},"retention_until":{"type":"string"},"consents":{"type":"array","items":{"type":"object","properties":{"purpose":{"type":"string","enum":["profile","first_task","colleague_context"]},"transmits_to_model":{"type":"boolean"},"granted_at":{"type":"string"}},"required":["purpose","transmits_to_model","granted_at"]}},"upload":{"anyOf":[{"type":"object","properties":{"filename":{"type":"string"},"size_bytes":{"type":"number"},"parse_status":{"type":"string","enum":["pending","parsing","parsed","failed"]},"parse_error":{"type":["string","null"]}},"required":["filename","size_bytes","parse_status","parse_error"]},{"type":"null"}]},"learning":{"type":"boolean"}},"required":["id","type","display_name","created_at","retention_until","consents","upload","learning"]}}},"required":["sources"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"addPastedSource","tags":["Workspace"],"summary":"Add pasted text with its consents","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"type":"string","minLength":1,"maxLength":200},"text":{"type":"string","minLength":1,"maxLength":50000},"learn":{"type":"boolean"},"use_for_first_task":{"type":"boolean"}},"required":["display_name","text","learn","use_for_first_task"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/uploads":{"post":{"operationId":"uploadFile","tags":["Workspace"],"summary":"Upload a file (PDF, Word, text; up to 5 MB) with its consents","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"learn","in":"query","required":false,"description":"1 to learn facts from it","schema":{"type":"string"}},{"name":"first_task","in":"query","required":false,"description":"1 to use it for the first task","schema":{"type":"string"}},{"name":"context","in":"query","required":false,"description":"1 so your colleagues may read it for your work (Ask)","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/sources/{id}":{"delete":{"operationId":"deleteSource","tags":["Workspace"],"summary":"Delete a source, its file, its text and what was learned from it","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/sources/{id}/consents":{"post":{"operationId":"changeConsent","tags":["Workspace"],"summary":"Give or withdraw one use of a source","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"purpose":{"type":"string","enum":["profile","first_task","colleague_context"]},"granted":{"type":"boolean"}},"required":["purpose","granted"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/profile-facts":{"get":{"operationId":"listProfileFacts","tags":["Workspace"],"summary":"What your colleagues know about you, and suggestions to review","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"facts":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"category":{"type":"string","enum":["role","task","preference","brand","audience","tool","other"]},"value":{"type":"string"},"source_kind":{"type":"string","enum":["user_said","document","website"]},"source_name":{"type":["string","null"]},"confidence":{"type":"number"},"suggested":{"type":"boolean"},"reviewed":{"type":"boolean"},"remembered":{"type":"boolean"},"created_at":{"type":"string"}},"required":["id","category","value","source_kind","source_name","confidence","suggested","reviewed","remembered","created_at"]}},"learning":{"type":"boolean"}},"required":["facts","learning"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"addProfileFact","tags":["Workspace"],"summary":"Tell your colleagues something about your work","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","enum":["role","task","preference","brand","audience","tool","other"]},"value":{"type":"string","minLength":1,"maxLength":500}},"required":["category","value"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/profile-facts/{id}":{"patch":{"operationId":"reviewProfileFact","tags":["Workspace"],"summary":"Edit, approve or say \"do not remember\"","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":500},"decision":{"type":"string","enum":["approve","do_not_remember"]}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"removeProfileFact","tags":["Workspace"],"summary":"Remove a fact","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/recommendations":{"get":{"operationId":"listRecommendations","tags":["Workspace"],"summary":"Colleagues recommended for your work","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"recommendations":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"tagline":{"type":"string"},"can_do_today":{"type":"array","items":{"type":"string"}},"later":{"type":"array","items":{"type":"string"}},"availability":{"type":"string","enum":["available","needs_connection","coming_later"]},"example":{"type":"object","properties":{"input":{"type":"string"},"output":{"type":"string"}},"required":["input","output"]},"colleague_id":{"anyOf":[{"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)$"},{"type":"null"}]}},"required":["slug","name","role","tagline","can_do_today","later","availability","example","colleague_id"]}}},"required":["recommendations"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/recommendations/add":{"post":{"operationId":"addRecommendedColleague","tags":["Workspace"],"summary":"Add a recommended colleague (drafts only)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agent_slug":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?$"},"display_name":{"type":"string","minLength":1,"maxLength":120}},"required":["agent_slug"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/first-task":{"post":{"operationId":"startFirstTask","tags":["Workspace"],"summary":"Your first real task: a draft, saved","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["post","brief","reply","follow_up"]},"angle":{"type":"string","minLength":1,"maxLength":160},"details":{"type":"string","minLength":1,"maxLength":8000},"colleague_id":{"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":["kind","angle","details"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"getFirstTask","tags":["Workspace"],"summary":"Your first task's draft, or why there is none","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["not_started","working","saved","failed"]},"colleague":{"anyOf":[{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},{"type":"null"}]},"draft":{"anyOf":[{"type":"object","properties":{"id":{"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)$"},"title":{"type":"string"},"text":{"type":"string"},"created_at":{"type":"string"}},"required":["id","title","text","created_at"]},{"type":"null"}]},"reason":{"type":["string","null"]}},"required":["status","colleague","draft","reason"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/summary":{"get":{"operationId":"getFirstDaySummary","tags":["Workspace"],"summary":"What is true after your First Day","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ai_connected":{"type":"boolean"},"facts_approved":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"colleagues_active":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"drafts_saved":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"initiatives_on":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"connections_not_configured":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["ai_connected","facts_approved","colleagues_active","drafts_saved","initiatives_on","connections_not_configured"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/profile":{"delete":{"operationId":"deleteMyProfile","tags":["Workspace"],"summary":"Delete my profile (facts, uploads, colleagues' memories, my own AI key)","description":"Signed-in session only. Needs a recent sign-in (step-up).","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"facts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"uploads":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"documents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sources":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"memories":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"provider_connections_revoked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["facts","uploads","documents","sources","memories","provider_connections_revoked"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/intent/preview":{"post":{"operationId":"previewIntent","tags":["Requests"],"summary":"What Ask would do with your words: a plan, questions, what needs permission","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":2,"maxLength":10000}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["task","automation","preference","question","colleague"]},"title":{"type":"string"},"details":{"type":"string"},"schedule":{"anyOf":[{"type":"object","properties":{"cron":{"type":"string"},"text":{"type":"string"}},"required":["cron","text"]},{"type":"null"}]},"effects":{"type":"array","items":{"type":"string","enum":["publishes_externally","contacts_people","deletes_data","spends_money"]}},"questions":{"type":"array","items":{"type":"string","enum":["when","what_result"]}},"preference":{"type":["string","null"]},"colleague":{"anyOf":[{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},{"type":"null"}]},"ai_on":{"type":"boolean"}},"required":["kind","title","details","schedule","effects","questions","preference","colleague","ai_on"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/intent/confirm":{"post":{"operationId":"confirmIntent","tags":["Requests"],"summary":"Go ahead with Ask's plan","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["task","automation","preference","question","colleague"]},"title":{"type":"string","minLength":3,"maxLength":200},"details":{"type":"string","minLength":1,"maxLength":10000},"schedule":{"default":null,"anyOf":[{"type":"string","minLength":2,"maxLength":200},{"type":"null"}]},"effects":{"default":[],"type":"array","items":{"type":"string","enum":["publishes_externally","contacts_people","deletes_data","spends_money"]}},"preference":{"default":null,"anyOf":[{"type":"string","minLength":1,"maxLength":500},{"type":"null"}]},"colleague_id":{"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)$"},"source_ids":{"default":[],"maxItems":5,"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":["kind","title","details"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"outcome":{"type":"string","enum":["request","fact","colleague","not_kept"]},"request_id":{"anyOf":[{"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)$"},{"type":"null"}]}},"required":["outcome","request_id"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/requests/{id}/accept":{"post":{"operationId":"acceptWorkResult","tags":["Requests"],"summary":"Accept the result of a request","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/requests/{id}/rerun":{"post":{"operationId":"rerunWorkRequest","tags":["Requests"],"summary":"Run a request again","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/requests/{id}/stop":{"post":{"operationId":"stopWorkRequest","tags":["Requests"],"summary":"Stop a request that is running","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/requests/{id}/recurring":{"post":{"operationId":"makeRecurring","tags":["Requests"],"summary":"Make a request recurring (a draft automation)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"schedule":{"type":"string","minLength":2,"maxLength":200}},"required":["schedule"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/automations":{"get":{"operationId":"listAutomations","tags":["Requests"],"summary":"Your automations","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"automations":{"type":"array","items":{"type":"object","properties":{"id":{"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":{"type":"string"},"status":{"type":"string","enum":["draft","active","paused","archived"]},"schedule_text":{"type":["string","null"]},"timezone":{"type":"string"},"next_run_at":{"type":["string","null"]},"colleague":{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},"steps":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["agent.task","approval","notify"]},"label":{"type":"string"}},"required":["kind","label"]}},"estimated_wu":{"type":"number"},"last_run":{"anyOf":[{"type":"object","properties":{"id":{"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)$"},"trigger":{"type":"string","enum":["manual","cron"]},"status":{"type":"string","enum":["queued","running","waiting_approval","completed","failed","cancelled"]},"error":{"type":["string","null"]},"scheduled_for":{"type":["string","null"]},"started_at":{"type":["string","null"]},"ended_at":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","trigger","status","error","scheduled_for","started_at","ended_at","created_at"]},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","name","status","schedule_text","timezone","next_run_at","colleague","steps","estimated_wu","last_run","created_at"]}}},"required":["automations"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/automations/{id}":{"get":{"operationId":"getAutomation","tags":["Requests"],"summary":"An automation and its recent runs","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"automation":{"type":"object","properties":{"id":{"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":{"type":"string"},"status":{"type":"string","enum":["draft","active","paused","archived"]},"schedule_text":{"type":["string","null"]},"timezone":{"type":"string"},"next_run_at":{"type":["string","null"]},"colleague":{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},"steps":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["agent.task","approval","notify"]},"label":{"type":"string"}},"required":["kind","label"]}},"estimated_wu":{"type":"number"},"last_run":{"anyOf":[{"type":"object","properties":{"id":{"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)$"},"trigger":{"type":"string","enum":["manual","cron"]},"status":{"type":"string","enum":["queued","running","waiting_approval","completed","failed","cancelled"]},"error":{"type":["string","null"]},"scheduled_for":{"type":["string","null"]},"started_at":{"type":["string","null"]},"ended_at":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","trigger","status","error","scheduled_for","started_at","ended_at","created_at"]},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","name","status","schedule_text","timezone","next_run_at","colleague","steps","estimated_wu","last_run","created_at"]},"runs":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"trigger":{"type":"string","enum":["manual","cron"]},"status":{"type":"string","enum":["queued","running","waiting_approval","completed","failed","cancelled"]},"error":{"type":["string","null"]},"scheduled_for":{"type":["string","null"]},"started_at":{"type":["string","null"]},"ended_at":{"type":["string","null"]},"created_at":{"type":"string"},"steps":{"type":"array","items":{"type":"object","properties":{"step_id":{"type":"string"},"kind":{"type":"string"},"status":{"type":"string"},"deliverable_id":{"anyOf":[{"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)$"},{"type":"null"}]},"approval_id":{"anyOf":[{"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)$"},{"type":"null"}]},"result_text":{"type":["string","null"]}},"required":["step_id","kind","status","deliverable_id","approval_id","result_text"]}}},"required":["id","trigger","status","error","scheduled_for","started_at","ended_at","created_at","steps"]}}},"required":["automation","runs"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/automations/{id}/activate":{"post":{"operationId":"activateAutomation","tags":["Requests"],"summary":"Switch an automation on","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/automations/{id}/pause":{"post":{"operationId":"pauseAutomation","tags":["Requests"],"summary":"Pause an automation","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/automations/{id}/archive":{"post":{"operationId":"archiveAutomation","tags":["Requests"],"summary":"Archive an automation","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/automations/{id}/run":{"post":{"operationId":"runAutomation","tags":["Requests"],"summary":"Run an automation now","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/automation-runs/{id}/cancel":{"post":{"operationId":"cancelAutomationRun","tags":["Requests"],"summary":"Cancel a run","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/costs":{"get":{"operationId":"getCosts","tags":["Requests"],"summary":"What your work costs this month, who pays, and the limits that apply","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"month":{"type":"object","properties":{"spent_wu":{"type":"number"},"by_colleague":{"type":"array","items":{"type":"object","properties":{"id":{"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":{"type":"string"},"wu":{"type":"number"}},"required":["id","name","wu"]}},"by_source":{"type":"object","properties":{"org":{"type":"number"},"user":{"type":"number"},"platform":{"type":"number"}},"required":["org","user","platform"]}},"required":["spent_wu","by_colleague","by_source"]},"caps":{"type":"array","items":{"type":"object","properties":{"scope":{"type":"string","enum":["org","team","user","deployment","automation"]},"period":{"type":"string"},"cap_wu":{"type":"number"},"used_wu":{"type":"number"},"on_exceed":{"type":"string","enum":["block","approval"]}},"required":["scope","period","cap_wu","used_wu","on_exceed"]}},"tasks":{"type":"array","items":{"type":"object","properties":{"request_id":{"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)$"},"title":{"type":"string"},"status":{"type":"string"},"estimate_cents":{"type":["number","null"]},"actual_wu":{"type":"number"},"created_at":{"type":"string"}},"required":["request_id","title","status","estimate_cents","actual_wu","created_at"]}},"bills":{"type":"string","enum":["org","user","platform","none"]}},"required":["month","caps","tasks","bills"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/activity":{"get":{"operationId":"getMyActivity","tags":["Requests"],"summary":"Your activity history (format=csv to export)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"format","in":"query","required":false,"description":"csv to download","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"activity":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string"},"action":{"type":"string"},"target_type":{"type":["string","null"]},"target_id":{"type":["string","null"]}},"required":["at","action","target_type","target_id"]}}},"required":["activity"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/initiatives":{"get":{"operationId":"listInitiatives","tags":["Workspace"],"summary":"Your initiatives (all off by default) and the emergency stop","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"initiatives":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["weekly_plan","daily_brief","content_ideas","follow_ups"]},"recommended":{"type":"boolean"},"enabled":{"type":"boolean"},"level":{"type":"string","enum":["suggest","prepare","execute_approved"]},"schedule_text":{"type":"string"},"timezone":{"type":"string"},"quiet_hours":{"type":"object","properties":{"start":{"type":"string","pattern":"^([01]?\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]?\\d|2[0-3]):[0-5]\\d$"}},"required":["start","end"],"additionalProperties":false},"daily_cap":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"needs_sources":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]}},"next_run_at":{"type":["string","null"]},"colleague":{"anyOf":[{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},{"type":"null"}]}},"required":["kind","recommended","enabled","level","schedule_text","timezone","quiet_hours","daily_cap","needs_sources","sources","next_run_at","colleague"]}},"stopped":{"type":"boolean"},"stopped_at":{"type":["string","null"]},"has_colleague":{"type":"boolean"}},"required":["initiatives","stopped","stopped_at","has_colleague"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/initiatives/{kind}":{"patch":{"operationId":"updateInitiative","tags":["Workspace"],"summary":"Switch an initiative on or off, its level, schedule in plain words, quiet hours, sources","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string"}},{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"level":{"type":"string","enum":["suggest","prepare","execute_approved"]},"schedule":{"type":"string","minLength":2,"maxLength":200},"quiet_hours":{"type":"object","properties":{"start":{"type":"string","pattern":"^([01]?\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]?\\d|2[0-3]):[0-5]\\d$"}},"required":["start","end"],"additionalProperties":false},"daily_cap":{"type":"integer","minimum":1,"maximum":20},"source_ids":{"maxItems":10,"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)$"}},"colleague_id":{"anyOf":[{"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)$"},{"type":"null"}]}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"initiatives":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["weekly_plan","daily_brief","content_ideas","follow_ups"]},"recommended":{"type":"boolean"},"enabled":{"type":"boolean"},"level":{"type":"string","enum":["suggest","prepare","execute_approved"]},"schedule_text":{"type":"string"},"timezone":{"type":"string"},"quiet_hours":{"type":"object","properties":{"start":{"type":"string","pattern":"^([01]?\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]?\\d|2[0-3]):[0-5]\\d$"}},"required":["start","end"],"additionalProperties":false},"daily_cap":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"needs_sources":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]}},"next_run_at":{"type":["string","null"]},"colleague":{"anyOf":[{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},{"type":"null"}]}},"required":["kind","recommended","enabled","level","schedule_text","timezone","quiet_hours","daily_cap","needs_sources","sources","next_run_at","colleague"]}},"stopped":{"type":"boolean"},"stopped_at":{"type":["string","null"]},"has_colleague":{"type":"boolean"}},"required":["initiatives","stopped","stopped_at","has_colleague"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/initiatives/stop":{"put":{"operationId":"stopInitiatives","tags":["Workspace"],"summary":"The emergency stop: nothing new starts, waiting cards are cancelled","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stopped":{"type":"boolean"}},"required":["stopped"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"initiatives":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["weekly_plan","daily_brief","content_ideas","follow_ups"]},"recommended":{"type":"boolean"},"enabled":{"type":"boolean"},"level":{"type":"string","enum":["suggest","prepare","execute_approved"]},"schedule_text":{"type":"string"},"timezone":{"type":"string"},"quiet_hours":{"type":"object","properties":{"start":{"type":"string","pattern":"^([01]?\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]?\\d|2[0-3]):[0-5]\\d$"}},"required":["start","end"],"additionalProperties":false},"daily_cap":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"needs_sources":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]}},"next_run_at":{"type":["string","null"]},"colleague":{"anyOf":[{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},{"type":"null"}]}},"required":["kind","recommended","enabled","level","schedule_text","timezone","quiet_hours","daily_cap","needs_sources","sources","next_run_at","colleague"]}},"stopped":{"type":"boolean"},"stopped_at":{"type":["string","null"]},"has_colleague":{"type":"boolean"}},"required":["initiatives","stopped","stopped_at","has_colleague"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/initiatives/{kind}/try":{"post":{"operationId":"tryInitiative","tags":["Workspace"],"summary":"Try an initiative once now (a draft, nothing sent)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string"}},{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"outcome":{"type":"string","enum":["proposed","missed","skipped"]},"proposal_id":{"anyOf":[{"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)$"},{"type":"null"}]}},"required":["outcome","proposal_id"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/proposals":{"get":{"operationId":"listProposals","tags":["Workspace"],"summary":"Initiative cards: what was observed, why, what it used and cost","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"proposals":{"type":"array","items":{"type":"object","properties":{"id":{"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":{"type":"string","enum":["weekly_plan","daily_brief","content_ideas","follow_ups"]},"state":{"type":"string","enum":["suggested","preparing","prepared","approved","dismissed","snoozed","expired","missed"]},"observation":{"type":"string"},"rationale":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"facts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"confidence":{"type":"number"},"cost_estimate_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scheduled_for":{"type":"string"},"prepared_at":{"type":["string","null"]},"missed_reason":{"type":["string","null"]},"snoozed_until":{"type":["string","null"]},"colleague":{"anyOf":[{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},{"type":"null"}]},"draft":{"anyOf":[{"type":"object","properties":{"id":{"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)$"},"title":{"type":"string"},"text":{"type":"string"}},"required":["id","title","text"]},{"type":"null"}]},"rating":{"anyOf":[{"type":"string","enum":["up","down"]},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","kind","state","observation","rationale","sources","facts","confidence","cost_estimate_cents","scheduled_for","prepared_at","missed_reason","snoozed_until","colleague","draft","rating","created_at"]}}},"required":["proposals"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/proposals/{id}/decision":{"post":{"operationId":"decideProposal","tags":["Workspace"],"summary":"Approve, prepare, dismiss (with a reason), snooze, stop recurring or rate a card","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"action":{"type":"string","const":"approve"}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"prepare"}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"dismiss"},"reason":{"type":"string","maxLength":500}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"snooze"},"hours":{"default":24,"type":"integer","minimum":1,"maximum":168}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"stop_recurring"}},"required":["action"],"additionalProperties":false},{"type":"object","properties":{"action":{"type":"string","const":"rate"},"value":{"type":"string","enum":["up","down"]}},"required":["action","value"],"additionalProperties":false}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"proposal":{"type":"object","properties":{"id":{"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":{"type":"string","enum":["weekly_plan","daily_brief","content_ideas","follow_ups"]},"state":{"type":"string","enum":["suggested","preparing","prepared","approved","dismissed","snoozed","expired","missed"]},"observation":{"type":"string"},"rationale":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"facts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"confidence":{"type":"number"},"cost_estimate_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scheduled_for":{"type":"string"},"prepared_at":{"type":["string","null"]},"missed_reason":{"type":["string","null"]},"snoozed_until":{"type":["string","null"]},"colleague":{"anyOf":[{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},{"type":"null"}]},"draft":{"anyOf":[{"type":"object","properties":{"id":{"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)$"},"title":{"type":"string"},"text":{"type":"string"}},"required":["id","title","text"]},{"type":"null"}]},"rating":{"anyOf":[{"type":"string","enum":["up","down"]},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","kind","state","observation","rationale","sources","facts","confidence","cost_estimate_cents","scheduled_for","prepared_at","missed_reason","snoozed_until","colleague","draft","rating","created_at"]}},"required":["proposal"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/orgs/{id}/left-colleagues":{"get":{"operationId":"listLeftColleagues","tags":["Colleagues"],"summary":"Colleagues left by members who left (owners and admins)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"colleagues":{"type":"array","items":{"type":"object","properties":{"id":{"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":{"type":"string"},"agent_name":{"type":"string"},"suspended_at":{"type":"string"},"deliverables":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"memories":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","name","agent_name","suspended_at","deliverables","memories"]}}},"required":["colleagues"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/colleagues/{id}/hand-over":{"post":{"operationId":"handOverColleague","tags":["Colleagues"],"summary":"Hand a leaver's colleague to another member (paused, drafts only) or end it","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"to_user_id":{"anyOf":[{"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)$"},{"type":"null"}]}},"required":["to_user_id"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"outcome":{"type":"string","enum":["handed_over","ended"]}},"required":["outcome"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/content-batches/preview":{"post":{"operationId":"previewContentTable","tags":["Workspace"],"summary":"What is in a table, and which column is likely the address, title, text or keyword","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"table":{"type":"string","minLength":1,"maxLength":1000000}},"required":["table"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"columns":{"type":"array","items":{"type":"string"}},"suggested":{"type":"object","properties":{"url":{"type":"object","properties":{"column":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"confidence":{"type":"number"}},"required":["column","confidence"]},"title":{"type":"object","properties":{"column":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"confidence":{"type":"number"}},"required":["column","confidence"]},"text":{"type":"object","properties":{"column":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"confidence":{"type":"number"}},"required":["column","confidence"]},"keyword":{"type":"object","properties":{"column":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"confidence":{"type":"number"}},"required":["column","confidence"]}},"required":["url","title","text","keyword"]},"sample":{"type":"array","items":{"type":"array","items":{"type":"string"}}},"row_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"truncated_rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"batches":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["columns","suggested","sample","row_count","truncated_rows","batches"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/content-batches":{"post":{"operationId":"createContentBatches","tags":["Workspace"],"summary":"Keep a mapped table as batches of up to 50 rows, as they came","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160},"table":{"type":"string","minLength":1,"maxLength":1000000},"mapping":{"type":"object","properties":{"url":{"anyOf":[{"type":"integer","minimum":0,"maximum":49},{"type":"null"}]},"title":{"anyOf":[{"type":"integer","minimum":0,"maximum":49},{"type":"null"}]},"text":{"anyOf":[{"type":"integer","minimum":0,"maximum":49},{"type":"null"}]},"keyword":{"anyOf":[{"type":"integer","minimum":0,"maximum":49},{"type":"null"}]}},"required":["url","title","text","keyword"],"additionalProperties":false},"instructions":{"type":"string","maxLength":2000}},"required":["name","table","mapping"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"batch_ids":{"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)$"}},"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"duplicates_skipped":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["batch_ids","rows","duplicates_skipped"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"listContentBatches","tags":["Workspace"],"summary":"Your content batches","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"batches":{"type":"array","items":{"type":"object","properties":{"id":{"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":{"type":"string"},"status":{"type":"string","enum":["draft","running","paused","completed","cancelled"]},"waiting_reason":{"type":["string","null"]},"row_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cost_estimate_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"counts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"colleague":{"anyOf":[{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","name","status","waiting_reason","row_count","cost_estimate_cents","counts","colleague","created_at"]}}},"required":["batches"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/content-batches/{id}":{"get":{"operationId":"getContentBatch","tags":["Workspace"],"summary":"A batch with each row's original, draft, score, reasons and claims to check","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"batch":{"type":"object","properties":{"id":{"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":{"type":"string"},"status":{"type":"string","enum":["draft","running","paused","completed","cancelled"]},"waiting_reason":{"type":["string","null"]},"row_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cost_estimate_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"counts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"colleague":{"anyOf":[{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","name","status","waiting_reason","row_count","cost_estimate_cents","counts","colleague","created_at"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"row_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"url":{"type":["string","null"]},"title":{"type":["string","null"]},"keyword":{"type":["string","null"]},"status":{"type":"string","enum":["queued","needs_text","drafting","ready","approved","failed","skipped"]},"score":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"explanation":{"type":["string","null"]},"flags":{"type":"array","items":{"type":"string"}},"error":{"type":["string","null"]},"original_text":{"type":["string","null"]},"draft":{"anyOf":[{"type":"object","properties":{"id":{"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)$"},"text":{"type":"string"}},"required":["id","text"]},{"type":"null"}]}},"required":["id","row_index","url","title","keyword","status","score","explanation","flags","error","original_text","draft"]}}},"required":["batch","items"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/content-batches/{id}/start":{"post":{"operationId":"startContentBatch","tags":["Workspace"],"summary":"Start or resume a batch on your colleague (one row at a time, drafts only)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"colleague_id":{"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)$"}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"batch":{"type":"object","properties":{"id":{"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":{"type":"string"},"status":{"type":"string","enum":["draft","running","paused","completed","cancelled"]},"waiting_reason":{"type":["string","null"]},"row_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cost_estimate_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"counts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"colleague":{"anyOf":[{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","name","status","waiting_reason","row_count","cost_estimate_cents","counts","colleague","created_at"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"row_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"url":{"type":["string","null"]},"title":{"type":["string","null"]},"keyword":{"type":["string","null"]},"status":{"type":"string","enum":["queued","needs_text","drafting","ready","approved","failed","skipped"]},"score":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"explanation":{"type":["string","null"]},"flags":{"type":"array","items":{"type":"string"}},"error":{"type":["string","null"]},"original_text":{"type":["string","null"]},"draft":{"anyOf":[{"type":"object","properties":{"id":{"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)$"},"text":{"type":"string"}},"required":["id","text"]},{"type":"null"}]}},"required":["id","row_index","url","title","keyword","status","score","explanation","flags","error","original_text","draft"]}}},"required":["batch","items"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/content-batches/{id}/pause":{"post":{"operationId":"pauseContentBatch","tags":["Workspace"],"summary":"Pause a batch","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"batch":{"type":"object","properties":{"id":{"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":{"type":"string"},"status":{"type":"string","enum":["draft","running","paused","completed","cancelled"]},"waiting_reason":{"type":["string","null"]},"row_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cost_estimate_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"counts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"colleague":{"anyOf":[{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","name","status","waiting_reason","row_count","cost_estimate_cents","counts","colleague","created_at"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"row_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"url":{"type":["string","null"]},"title":{"type":["string","null"]},"keyword":{"type":["string","null"]},"status":{"type":"string","enum":["queued","needs_text","drafting","ready","approved","failed","skipped"]},"score":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"explanation":{"type":["string","null"]},"flags":{"type":"array","items":{"type":"string"}},"error":{"type":["string","null"]},"original_text":{"type":["string","null"]},"draft":{"anyOf":[{"type":"object","properties":{"id":{"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)$"},"text":{"type":"string"}},"required":["id","text"]},{"type":"null"}]}},"required":["id","row_index","url","title","keyword","status","score","explanation","flags","error","original_text","draft"]}}},"required":["batch","items"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/content-batches/{id}/cancel":{"post":{"operationId":"cancelContentBatch","tags":["Workspace"],"summary":"Cancel a batch (rows not started are skipped)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"batch":{"type":"object","properties":{"id":{"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":{"type":"string"},"status":{"type":"string","enum":["draft","running","paused","completed","cancelled"]},"waiting_reason":{"type":["string","null"]},"row_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cost_estimate_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"counts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"colleague":{"anyOf":[{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","name","status","waiting_reason","row_count","cost_estimate_cents","counts","colleague","created_at"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"row_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"url":{"type":["string","null"]},"title":{"type":["string","null"]},"keyword":{"type":["string","null"]},"status":{"type":"string","enum":["queued","needs_text","drafting","ready","approved","failed","skipped"]},"score":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"explanation":{"type":["string","null"]},"flags":{"type":"array","items":{"type":"string"}},"error":{"type":["string","null"]},"original_text":{"type":["string","null"]},"draft":{"anyOf":[{"type":"object","properties":{"id":{"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)$"},"text":{"type":"string"}},"required":["id","text"]},{"type":"null"}]}},"required":["id","row_index","url","title","keyword","status","score","explanation","flags","error","original_text","draft"]}}},"required":["batch","items"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/content-batches/{id}/export.csv":{"get":{"operationId":"exportContentBatch","tags":["Workspace"],"summary":"The original columns, then draft, score, reasons, claims to check and status","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"CSV file","content":{"text/csv":{"schema":{"type":"string"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/content-items/{id}/text":{"post":{"operationId":"giveContentItemText","tags":["Workspace"],"summary":"Give a row the article text it was missing","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":20000}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"batch":{"type":"object","properties":{"id":{"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":{"type":"string"},"status":{"type":"string","enum":["draft","running","paused","completed","cancelled"]},"waiting_reason":{"type":["string","null"]},"row_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cost_estimate_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"counts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"colleague":{"anyOf":[{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","name","status","waiting_reason","row_count","cost_estimate_cents","counts","colleague","created_at"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"row_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"url":{"type":["string","null"]},"title":{"type":["string","null"]},"keyword":{"type":["string","null"]},"status":{"type":"string","enum":["queued","needs_text","drafting","ready","approved","failed","skipped"]},"score":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"explanation":{"type":["string","null"]},"flags":{"type":"array","items":{"type":"string"}},"error":{"type":["string","null"]},"original_text":{"type":["string","null"]},"draft":{"anyOf":[{"type":"object","properties":{"id":{"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)$"},"text":{"type":"string"}},"required":["id","text"]},{"type":"null"}]}},"required":["id","row_index","url","title","keyword","status","score","explanation","flags","error","original_text","draft"]}}},"required":["batch","items"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/content-items/{id}/decision":{"post":{"operationId":"decideContentItem","tags":["Workspace"],"summary":"Approve a row's draft (nothing is published), skip it or run it again","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["approve","skip","retry"]}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"batch":{"type":"object","properties":{"id":{"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":{"type":"string"},"status":{"type":"string","enum":["draft","running","paused","completed","cancelled"]},"waiting_reason":{"type":["string","null"]},"row_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cost_estimate_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"counts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"colleague":{"anyOf":[{"type":"object","properties":{"id":{"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":{"type":"string"}},"required":["id","name"]},{"type":"null"}]},"created_at":{"type":"string"}},"required":["id","name","status","waiting_reason","row_count","cost_estimate_cents","counts","colleague","created_at"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"row_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"url":{"type":["string","null"]},"title":{"type":["string","null"]},"keyword":{"type":["string","null"]},"status":{"type":"string","enum":["queued","needs_text","drafting","ready","approved","failed","skipped"]},"score":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"explanation":{"type":["string","null"]},"flags":{"type":"array","items":{"type":"string"}},"error":{"type":["string","null"]},"original_text":{"type":["string","null"]},"draft":{"anyOf":[{"type":"object","properties":{"id":{"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)$"},"text":{"type":"string"}},"required":["id","text"]},{"type":"null"}]}},"required":["id","row_index","url","title","keyword","status","score","explanation","flags","error","original_text","draft"]}}},"required":["batch","items"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invitations/{token}":{"get":{"operationId":"previewInvitation","tags":["Org"],"summary":"What an invitation link is for","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"org_name":{"type":"string"},"role":{"type":"string"},"email_hint":{"type":"string"},"state":{"type":"string","enum":["open","expired","accepted"]},"email_matches":{"type":"boolean"}},"required":["org_name","role","email_hint","state","email_matches"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invitations/{token}/accept":{"post":{"operationId":"acceptInvitation","tags":["Org"],"summary":"Join the organization you were invited to","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"org_id":{"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)$"},"role":{"type":"string"}},"required":["org_id","role"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/approvals":{"get":{"operationId":"listApprovals","tags":["Approvals"],"summary":"Approvals by status","description":"API key scope: `approvals:read`.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"status","in":"query","required":false,"description":"pending (default), approved, rejected, expired or edited_approved","schema":{"type":"string"}},{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"approvals":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"contract_id":{"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)$"},"tool_key":{"type":"string"},"risk_class":{"type":"string"},"summary":{"type":"string"},"status":{"type":"string"},"expires_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"created_at":{"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)))$"}},"required":["id","contract_id","tool_key","risk_class","summary","status","expires_at","created_at"]}}},"required":["approvals"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"approvals:read"}},"/approvals/{id}/approve":{"post":{"operationId":"approve","tags":["Approvals"],"summary":"Approve, optionally with edits","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"edits":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/approvals/{id}/reject":{"post":{"operationId":"reject","tags":["Approvals"],"summary":"Reject with a reason","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":1000}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/org":{"get":{"operationId":"getOrg","tags":["Org"],"summary":"The organization","description":"API key scope: `org:read`.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"org":{"type":"object","properties":{"id":{"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":{"type":"string"},"slug":{"type":"string"},"country":{"type":["string","null"]},"timezone":{"type":"string"},"locale":{"type":"string","enum":["en","fr"]},"plan_key":{"type":["string","null"]},"created_at":{"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)))$"}},"required":["id","name","slug","country","timezone","locale","plan_key","created_at"]}},"required":["org"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"org:read"},"patch":{"operationId":"updateOrg","tags":["Org"],"summary":"Update the organization","description":"API key scope: `org:write`.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":80},"timezone":{"type":"string","minLength":1,"maxLength":64},"locale":{"type":"string","enum":["en","fr"]},"country":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}]}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"org":{"type":"object","properties":{"id":{"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":{"type":"string"},"slug":{"type":"string"},"country":{"type":["string","null"]},"timezone":{"type":"string"},"locale":{"type":"string","enum":["en","fr"]},"plan_key":{"type":["string","null"]},"created_at":{"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)))$"}},"required":["id","name","slug","country","timezone","locale","plan_key","created_at"]}},"required":["org"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"org:write"}},"/org/members":{"get":{"operationId":"listMembers","tags":["Org"],"summary":"Members and their roles","description":"API key scope: `members:read`. Cursor-paginated.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"limit","in":"query","required":false,"description":"Items per page, 1 to 100 (default 25).","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor of the previous page.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"user_id":{"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)$"},"full_name":{"type":["string","null"]},"role":{"type":"string"},"joined_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"created_at":{"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)))$"}},"required":["user_id","full_name","role","joined_at","created_at"]}},"next_cursor":{"type":["string","null"]}},"required":["members","next_cursor"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"members:read"}},"/org/members/{userId}":{"delete":{"operationId":"removeMember","tags":["Org"],"summary":"Remove a member (not an owner)","description":"API key scope: `members:write`.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string"}},{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"members:write"}},"/org/invitations":{"get":{"operationId":"listInvitations","tags":["Org"],"summary":"Open and accepted invitations","description":"API key scope: `members:read`. Cursor-paginated.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"limit","in":"query","required":false,"description":"Items per page, 1 to 100 (default 25).","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor of the previous page.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"invitations":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"email":{"type":"string"},"role":{"type":"string"},"expires_at":{"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)))$"},"accepted_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"created_at":{"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)))$"}},"required":["id","email","role","expires_at","accepted_at","created_at"]}},"next_cursor":{"type":["string","null"]}},"required":["invitations","next_cursor"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"members:read"},"post":{"operationId":"createInvitation","tags":["Org"],"summary":"Invite someone by email","description":"API key scope: `members:write`.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"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","manager","member","finance","viewer"]}},"required":["email","role"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"invitation":{"type":"object","properties":{"id":{"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)$"},"email":{"type":"string"},"role":{"type":"string"},"expires_at":{"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)))$"},"accepted_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"created_at":{"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)))$"}},"required":["id","email","role","expires_at","accepted_at","created_at"]}},"required":["invitation"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"members:write"}},"/org/invitations/{id}":{"delete":{"operationId":"deleteInvitation","tags":["Org"],"summary":"Withdraw an invitation","description":"API key scope: `members:write`.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"members:write"}},"/org/files":{"get":{"operationId":"listFiles","tags":["Org"],"summary":"Deliverables across your contracts","description":"API key scope: `files:read`. Cursor-paginated.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"limit","in":"query","required":false,"description":"Items per page, 1 to 100 (default 25).","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor of the previous page.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"contract_id":{"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)$"},"title":{"type":"string"},"type":{"type":"string"},"version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"status":{"type":"string"},"created_at":{"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)))$"}},"required":["id","contract_id","title","type","version","status","created_at"]}},"next_cursor":{"type":["string","null"]}},"required":["files","next_cursor"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"files:read"}},"/org/api-keys":{"get":{"operationId":"listApiKeys","tags":["Org"],"summary":"API keys (owners and admins)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"api_keys":{"type":"array","items":{"type":"object","properties":{"id":{"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":{"type":"string"},"prefix":{"type":"string"},"scopes":{"type":"array","items":{"type":"string","enum":["org:read","org:write","members:read","members:write","files:read","contracts:read","approvals:read","webhooks:read","webhooks:write"]}},"created_at":{"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)))$"},"last_used_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"revoked_at":{"anyOf":[{"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)))$"},{"type":"null"}]}},"required":["id","name","prefix","scopes","created_at","last_used_at","revoked_at"]}}},"required":["api_keys"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createApiKey","tags":["Org"],"summary":"Create an API key (the secret is shown once)","description":"Signed-in session only. Needs a recent sign-in (step-up).","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":60},"scopes":{"minItems":1,"maxItems":9,"type":"array","items":{"type":"string","enum":["org:read","org:write","members:read","members:write","files:read","contracts:read","approvals:read","webhooks:read","webhooks:write"]}}},"required":["name","scopes"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"api_key":{"type":"object","properties":{"id":{"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":{"type":"string"},"prefix":{"type":"string"},"scopes":{"type":"array","items":{"type":"string","enum":["org:read","org:write","members:read","members:write","files:read","contracts:read","approvals:read","webhooks:read","webhooks:write"]}},"created_at":{"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)))$"},"last_used_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"revoked_at":{"anyOf":[{"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)))$"},{"type":"null"}]}},"required":["id","name","prefix","scopes","created_at","last_used_at","revoked_at"]},"secret":{"type":"string"}},"required":["api_key","secret"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/org/api-keys/{id}":{"delete":{"operationId":"revokeApiKey","tags":["Org"],"summary":"Revoke an API key","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/org/webhooks":{"get":{"operationId":"listWebhooks","tags":["Webhooks"],"summary":"Webhook endpoints","description":"API key scope: `webhooks:read`.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"webhooks":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"url":{"type":"string"},"description":{"type":"string"},"events":{"type":"array","items":{"type":"string","enum":["approval.requested","deliverable.ready","contract.status_changed","report.ready","connection.expiring","contract.closed"]}},"enabled":{"type":"boolean"},"disabled_reason":{"type":["string","null"]},"consecutive_failures":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"last_success_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"last_failure_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"created_at":{"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)))$"}},"required":["id","url","description","events","enabled","disabled_reason","consecutive_failures","last_success_at","last_failure_at","created_at"]}}},"required":["webhooks"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"webhooks:read"},"post":{"operationId":"createWebhook","tags":["Webhooks"],"summary":"Add an endpoint (the signing secret is shown once)","description":"API key scope: `webhooks:write`.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","minLength":8,"maxLength":2000},"description":{"default":"","type":"string","maxLength":200},"events":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"string","enum":["approval.requested","deliverable.ready","contract.status_changed","report.ready","connection.expiring","contract.closed"]}}},"required":["url","events"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"webhook":{"type":"object","properties":{"id":{"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)$"},"url":{"type":"string"},"description":{"type":"string"},"events":{"type":"array","items":{"type":"string","enum":["approval.requested","deliverable.ready","contract.status_changed","report.ready","connection.expiring","contract.closed"]}},"enabled":{"type":"boolean"},"disabled_reason":{"type":["string","null"]},"consecutive_failures":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"last_success_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"last_failure_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"created_at":{"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)))$"}},"required":["id","url","description","events","enabled","disabled_reason","consecutive_failures","last_success_at","last_failure_at","created_at"]},"secret":{"type":"string"}},"required":["webhook","secret"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"webhooks:write"}},"/org/webhooks/{id}":{"patch":{"operationId":"updateWebhook","tags":["Webhooks"],"summary":"Change an endpoint, or switch it on or off","description":"API key scope: `webhooks:write`.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","minLength":8,"maxLength":2000},"description":{"type":"string","maxLength":200},"events":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"string","enum":["approval.requested","deliverable.ready","contract.status_changed","report.ready","connection.expiring","contract.closed"]}},"enabled":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"webhook":{"type":"object","properties":{"id":{"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)$"},"url":{"type":"string"},"description":{"type":"string"},"events":{"type":"array","items":{"type":"string","enum":["approval.requested","deliverable.ready","contract.status_changed","report.ready","connection.expiring","contract.closed"]}},"enabled":{"type":"boolean"},"disabled_reason":{"type":["string","null"]},"consecutive_failures":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"last_success_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"last_failure_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"created_at":{"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)))$"}},"required":["id","url","description","events","enabled","disabled_reason","consecutive_failures","last_success_at","last_failure_at","created_at"]}},"required":["webhook"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"webhooks:write"},"delete":{"operationId":"deleteWebhook","tags":["Webhooks"],"summary":"Delete an endpoint","description":"API key scope: `webhooks:write`.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"webhooks:write"}},"/org/webhooks/{id}/rotate-secret":{"post":{"operationId":"rotateWebhookSecret","tags":["Webhooks"],"summary":"Replace the signing secret (shown once)","description":"API key scope: `webhooks:write`.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"secret":{"type":"string"}},"required":["secret"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"webhooks:write"}},"/org/webhooks/{id}/test":{"post":{"operationId":"testWebhook","tags":["Webhooks"],"summary":"Queue a webhook.test event to the endpoint","description":"API key scope: `webhooks:write`.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"delivery":{"type":"object","properties":{"id":{"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)$"},"event_id":{"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)$"},"event_type":{"type":"string"},"status":{"type":"string","enum":["pending","succeeded","failed","cancelled"]},"attempts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"next_attempt_at":{"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)))$"},"last_status_code":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"last_error":{"type":["string","null"]},"delivered_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"created_at":{"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)))$"}},"required":["id","event_id","event_type","status","attempts","next_attempt_at","last_status_code","last_error","delivered_at","created_at"]}},"required":["delivery"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"webhooks:write"}},"/org/webhooks/{id}/deliveries":{"get":{"operationId":"listWebhookDeliveries","tags":["Webhooks"],"summary":"Recent deliveries to an endpoint","description":"API key scope: `webhooks:read`. Cursor-paginated.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"limit","in":"query","required":false,"description":"Items per page, 1 to 100 (default 25).","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"The next_cursor of the previous page.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"deliveries":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"event_id":{"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)$"},"event_type":{"type":"string"},"status":{"type":"string","enum":["pending","succeeded","failed","cancelled"]},"attempts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"next_attempt_at":{"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)))$"},"last_status_code":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"last_error":{"type":["string","null"]},"delivered_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"created_at":{"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)))$"}},"required":["id","event_id","event_type","status","attempts","next_attempt_at","last_status_code","last_error","delivered_at","created_at"]}},"next_cursor":{"type":["string","null"]}},"required":["deliveries","next_cursor"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-mya-scope":"webhooks:read"}},"/flags":{"get":{"operationId":"getFlags","tags":["Support"],"summary":"Feature flags for your organization","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/announcements":{"get":{"operationId":"listAnnouncements","tags":["Support"],"summary":"Banners for you","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/announcements/{id}/dismiss":{"post":{"operationId":"dismissAnnouncement","tags":["Support"],"summary":"Dismiss a banner","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/support/tickets":{"get":{"operationId":"listTickets","tags":["Support"],"summary":"Your organization's support requests","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createTicket","tags":["Support"],"summary":"Open a support request","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org_id":{"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)$"},"contract_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"subject":{"type":"string","minLength":3,"maxLength":200},"body":{"type":"string","minLength":1,"maxLength":10000},"priority":{"default":"normal","type":"string","enum":["low","normal","high","urgent"]}},"required":["org_id","subject","body"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/support/tickets/{id}":{"get":{"operationId":"getTicket","tags":["Support"],"summary":"A support request and its thread","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/support/tickets/{id}/messages":{"post":{"operationId":"replyTicket","tags":["Support"],"summary":"Reply on a support request","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"body":{"type":"string","minLength":1,"maxLength":10000}},"required":["body"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/support/tickets/{id}/consent":{"post":{"operationId":"grantConsent","tags":["Support"],"summary":"Let support look, for a limited time","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scope":{"type":"string","enum":["activity","chat"]},"hours":{"type":"integer","minimum":1,"maximum":720}},"required":["scope","hours"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"revokeConsent","tags":["Support"],"summary":"Withdraw support's access","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/requests":{"get":{"operationId":"listWorkRequests","tags":["Requests"],"summary":"Job and automation requests you can see in the organization","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"requests":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"org_id":{"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":{"type":"string","enum":["job","automation"]},"title":{"type":"string"},"details":{"type":"string"},"schedule":{"type":["string","null"]},"consequential_effects":{"type":"array","items":{"type":"string","enum":["publishes_externally","contacts_people","deletes_data","spends_money"]}},"status":{"type":"string","enum":["needs_permission","preparing","waiting_for_review","working","paused","partially_completed","completed","failed"]},"requested_by":{"anyOf":[{"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)$"},{"type":"null"}]},"requester_name":{"type":["string","null"]},"decided_by":{"anyOf":[{"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)$"},{"type":"null"}]},"decider_name":{"type":["string","null"]},"decided_at":{"type":["string","null"]},"decision_note":{"type":["string","null"]},"estimated_cost_cents":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"budget_hold":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"mine":{"type":"boolean"},"waiting_reason":{"default":null,"type":["string","null"]},"deployment_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"colleague_name":{"default":null,"type":["string","null"]},"automation_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"result_deliverable_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"can_decide":{"type":"boolean"}},"required":["id","org_id","kind","title","details","schedule","consequential_effects","status","requested_by","requester_name","decided_by","decider_name","decided_at","decision_note","estimated_cost_cents","budget_hold","created_at","updated_at","mine","can_decide"]}}},"required":["requests"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createWorkRequest","tags":["Requests"],"summary":"Ask for a one-time job or an automation","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org_id":{"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":{"type":"string","enum":["job","automation"]},"title":{"type":"string","minLength":3,"maxLength":200},"details":{"type":"string","minLength":1,"maxLength":10000},"schedule":{"default":null,"anyOf":[{"type":"string","minLength":2,"maxLength":200},{"type":"null"}]},"consequential_effects":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","enum":["publishes_externally","contacts_people","deletes_data","spends_money"]}},"estimated_cost_cents":{"type":"integer","minimum":0,"maximum":100000000},"deployment_id":{"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)$"},"source_ids":{"default":[],"maxItems":5,"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":["org_id","kind","title","details"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"request":{"type":"object","properties":{"id":{"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)$"},"org_id":{"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":{"type":"string","enum":["job","automation"]},"title":{"type":"string"},"details":{"type":"string"},"schedule":{"type":["string","null"]},"consequential_effects":{"type":"array","items":{"type":"string","enum":["publishes_externally","contacts_people","deletes_data","spends_money"]}},"status":{"type":"string","enum":["needs_permission","preparing","waiting_for_review","working","paused","partially_completed","completed","failed"]},"requested_by":{"anyOf":[{"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)$"},{"type":"null"}]},"requester_name":{"type":["string","null"]},"decided_by":{"anyOf":[{"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)$"},{"type":"null"}]},"decider_name":{"type":["string","null"]},"decided_at":{"type":["string","null"]},"decision_note":{"type":["string","null"]},"estimated_cost_cents":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"budget_hold":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"mine":{"type":"boolean"},"waiting_reason":{"default":null,"type":["string","null"]},"deployment_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"colleague_name":{"default":null,"type":["string","null"]},"automation_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"result_deliverable_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"can_decide":{"type":"boolean"}},"required":["id","org_id","kind","title","details","schedule","consequential_effects","status","requested_by","requester_name","decided_by","decider_name","decided_at","decision_note","estimated_cost_cents","budget_hold","created_at","updated_at","mine","can_decide"]}},"required":["request"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/requests/{id}":{"get":{"operationId":"getWorkRequest","tags":["Requests"],"summary":"One request with its history","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"request":{"type":"object","properties":{"id":{"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)$"},"org_id":{"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":{"type":"string","enum":["job","automation"]},"title":{"type":"string"},"details":{"type":"string"},"schedule":{"type":["string","null"]},"consequential_effects":{"type":"array","items":{"type":"string","enum":["publishes_externally","contacts_people","deletes_data","spends_money"]}},"status":{"type":"string","enum":["needs_permission","preparing","waiting_for_review","working","paused","partially_completed","completed","failed"]},"requested_by":{"anyOf":[{"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)$"},{"type":"null"}]},"requester_name":{"type":["string","null"]},"decided_by":{"anyOf":[{"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)$"},{"type":"null"}]},"decider_name":{"type":["string","null"]},"decided_at":{"type":["string","null"]},"decision_note":{"type":["string","null"]},"estimated_cost_cents":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"budget_hold":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"mine":{"type":"boolean"},"waiting_reason":{"default":null,"type":["string","null"]},"deployment_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"colleague_name":{"default":null,"type":["string","null"]},"automation_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"result_deliverable_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"can_decide":{"type":"boolean"},"events":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"status":{"type":"string","enum":["needs_permission","preparing","waiting_for_review","working","paused","partially_completed","completed","failed"]},"actor_name":{"type":["string","null"]},"note":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","status","actor_name","note","created_at"]}},"results":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"type":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"}},"required":["id","type","title","text"]}},"actual_wu":{"default":0,"type":"number"},"running_session_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"automation":{"default":null,"anyOf":[{"type":"object","properties":{"id":{"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)$"},"status":{"type":"string"},"schedule_text":{"type":["string","null"]},"next_run_at":{"type":["string","null"]}},"required":["id","status","schedule_text","next_run_at"]},{"type":"null"}]},"can_rerun":{"default":false,"type":"boolean"}},"required":["id","org_id","kind","title","details","schedule","consequential_effects","status","requested_by","requester_name","decided_by","decider_name","decided_at","decision_note","estimated_cost_cents","budget_hold","created_at","updated_at","mine","can_decide","events"]}},"required":["request"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/requests/{id}/approve":{"post":{"operationId":"approveWorkRequest","tags":["Requests"],"summary":"Give permission for a request's consequential steps","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"note":{"type":"string","minLength":1,"maxLength":2000}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"request":{"type":"object","properties":{"id":{"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)$"},"org_id":{"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":{"type":"string","enum":["job","automation"]},"title":{"type":"string"},"details":{"type":"string"},"schedule":{"type":["string","null"]},"consequential_effects":{"type":"array","items":{"type":"string","enum":["publishes_externally","contacts_people","deletes_data","spends_money"]}},"status":{"type":"string","enum":["needs_permission","preparing","waiting_for_review","working","paused","partially_completed","completed","failed"]},"requested_by":{"anyOf":[{"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)$"},{"type":"null"}]},"requester_name":{"type":["string","null"]},"decided_by":{"anyOf":[{"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)$"},{"type":"null"}]},"decider_name":{"type":["string","null"]},"decided_at":{"type":["string","null"]},"decision_note":{"type":["string","null"]},"estimated_cost_cents":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"budget_hold":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"mine":{"type":"boolean"},"waiting_reason":{"default":null,"type":["string","null"]},"deployment_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"colleague_name":{"default":null,"type":["string","null"]},"automation_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"result_deliverable_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"can_decide":{"type":"boolean"}},"required":["id","org_id","kind","title","details","schedule","consequential_effects","status","requested_by","requester_name","decided_by","decider_name","decided_at","decision_note","estimated_cost_cents","budget_hold","created_at","updated_at","mine","can_decide"]}},"required":["request"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/workspace/requests/{id}/reject":{"post":{"operationId":"rejectWorkRequest","tags":["Requests"],"summary":"Refuse permission, saying why","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","minLength":1,"maxLength":2000}},"required":["reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"request":{"type":"object","properties":{"id":{"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)$"},"org_id":{"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":{"type":"string","enum":["job","automation"]},"title":{"type":"string"},"details":{"type":"string"},"schedule":{"type":["string","null"]},"consequential_effects":{"type":"array","items":{"type":"string","enum":["publishes_externally","contacts_people","deletes_data","spends_money"]}},"status":{"type":"string","enum":["needs_permission","preparing","waiting_for_review","working","paused","partially_completed","completed","failed"]},"requested_by":{"anyOf":[{"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)$"},{"type":"null"}]},"requester_name":{"type":["string","null"]},"decided_by":{"anyOf":[{"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)$"},{"type":"null"}]},"decider_name":{"type":["string","null"]},"decided_at":{"type":["string","null"]},"decision_note":{"type":["string","null"]},"estimated_cost_cents":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"budget_hold":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"mine":{"type":"boolean"},"waiting_reason":{"default":null,"type":["string","null"]},"deployment_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"colleague_name":{"default":null,"type":["string","null"]},"automation_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"result_deliverable_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"can_decide":{"type":"boolean"}},"required":["id","org_id","kind","title","details","schedule","consequential_effects","status","requested_by","requester_name","decided_by","decider_name","decided_at","decision_note","estimated_cost_cents","budget_hold","created_at","updated_at","mine","can_decide"]}},"required":["request"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/hub/policies":{"get":{"operationId":"listHubPolicies","tags":["Hub"],"summary":"The organization's AI policies (owners and admins, two-step session)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"policies":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"org_id":{"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":{"type":"string"},"autonomy":{"type":"string","enum":["L0","L1","L2"]},"always_approve":{"type":"array","items":{"type":"string"}},"blocked_tools":{"type":"array","items":{"type":"string"}},"working_hours":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"data_classes":{"type":"array","items":{"type":"string"}},"created_by":{"anyOf":[{"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)$"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","org_id","name","autonomy","always_approve","blocked_tools","working_hours","data_classes","created_by","created_at","updated_at"]}}},"required":["policies"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createHubPolicy","tags":["Hub"],"summary":"Create an AI policy","description":"Signed-in session only. Needs a recent sign-in (step-up).","security":[{"session":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org_id":{"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":{"type":"string","minLength":1,"maxLength":120},"autonomy":{"default":"L1","type":"string","enum":["L0","L1","L2"]},"always_approve":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","enum":["write_internal","publish","financial","admin"]}},"data_classes":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","enum":["public","internal","confidential","personal"]}}},"required":["org_id","name"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"policy":{"type":"object","properties":{"id":{"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)$"},"org_id":{"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":{"type":"string"},"autonomy":{"type":"string","enum":["L0","L1","L2"]},"always_approve":{"type":"array","items":{"type":"string"}},"blocked_tools":{"type":"array","items":{"type":"string"}},"working_hours":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"data_classes":{"type":"array","items":{"type":"string"}},"created_by":{"anyOf":[{"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)$"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","org_id","name","autonomy","always_approve","blocked_tools","working_hours","data_classes","created_by","created_at","updated_at"]}},"required":["policy"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/hub/policies/{id}":{"patch":{"operationId":"updateHubPolicy","tags":["Hub"],"summary":"Change an AI policy","description":"Signed-in session only. Needs a recent sign-in (step-up).","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"autonomy":{"type":"string","enum":["L0","L1","L2"]},"always_approve":{"maxItems":4,"type":"array","items":{"type":"string","enum":["write_internal","publish","financial","admin"]}},"data_classes":{"maxItems":4,"type":"array","items":{"type":"string","enum":["public","internal","confidential","personal"]}}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"policy":{"type":"object","properties":{"id":{"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)$"},"org_id":{"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":{"type":"string"},"autonomy":{"type":"string","enum":["L0","L1","L2"]},"always_approve":{"type":"array","items":{"type":"string"}},"blocked_tools":{"type":"array","items":{"type":"string"}},"working_hours":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"data_classes":{"type":"array","items":{"type":"string"}},"created_by":{"anyOf":[{"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)$"},{"type":"null"}]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","org_id","name","autonomy","always_approve","blocked_tools","working_hours","data_classes","created_by","created_at","updated_at"]}},"required":["policy"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/hub/budgets":{"get":{"operationId":"listHubBudgets","tags":["Hub"],"summary":"The organization's AI budgets with what is reserved this period","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"budgets":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"org_id":{"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)$"},"scope_type":{"type":"string","enum":["org","team","user","deployment","automation"]},"scope_id":{"anyOf":[{"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)$"},{"type":"null"}]},"period":{"type":"string","enum":["day","week","month","total"]},"hard_cap_cents":{"type":"integer","minimum":0,"maximum":9007199254740991},"soft_alert_pct":{"type":"integer","minimum":1,"maximum":100},"on_exceed":{"type":"string","enum":["block","approval"]},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"active":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"scope_name":{"type":["string","null"]},"period_start":{"type":["string","null"]},"reserved_cents":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","org_id","scope_type","scope_id","period","hard_cap_cents","soft_alert_pct","on_exceed","currency","active","created_at","updated_at","scope_name","period_start","reserved_cents"]}}},"required":["budgets"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createHubBudget","tags":["Hub"],"summary":"Set an AI budget for the organization or one member","description":"Signed-in session only. Needs a recent sign-in (step-up).","security":[{"session":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Send the same key to retry safely: the first answer is replayed.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"org_id":{"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)$"},"scope_type":{"type":"string","enum":["org","user"]},"scope_id":{"default":null,"anyOf":[{"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)$"},{"type":"null"}]},"period":{"default":"month","type":"string","enum":["day","week","month","total"]},"hard_cap_cents":{"type":"integer","minimum":0,"maximum":2147483647},"soft_alert_pct":{"default":80,"type":"integer","minimum":1,"maximum":100},"on_exceed":{"default":"approval","type":"string","enum":["block","approval"]},"active":{"default":true,"type":"boolean"}},"required":["org_id","scope_type","hard_cap_cents"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"budget":{"type":"object","properties":{"id":{"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)$"},"org_id":{"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)$"},"scope_type":{"type":"string","enum":["org","team","user","deployment","automation"]},"scope_id":{"anyOf":[{"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)$"},{"type":"null"}]},"period":{"type":"string","enum":["day","week","month","total"]},"hard_cap_cents":{"type":"integer","minimum":0,"maximum":9007199254740991},"soft_alert_pct":{"type":"integer","minimum":1,"maximum":100},"on_exceed":{"type":"string","enum":["block","approval"]},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"active":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"scope_name":{"type":["string","null"]},"period_start":{"type":["string","null"]},"reserved_cents":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","org_id","scope_type","scope_id","period","hard_cap_cents","soft_alert_pct","on_exceed","currency","active","created_at","updated_at","scope_name","period_start","reserved_cents"]}},"required":["budget"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/hub/budgets/{id}":{"patch":{"operationId":"updateHubBudget","tags":["Hub"],"summary":"Change an AI budget","description":"Signed-in session only. Needs a recent sign-in (step-up).","security":[{"session":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"period":{"type":"string","enum":["day","week","month","total"]},"hard_cap_cents":{"type":"integer","minimum":0,"maximum":2147483647},"soft_alert_pct":{"type":"integer","minimum":1,"maximum":100},"on_exceed":{"type":"string","enum":["block","approval"]},"active":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"budget":{"type":"object","properties":{"id":{"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)$"},"org_id":{"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)$"},"scope_type":{"type":"string","enum":["org","team","user","deployment","automation"]},"scope_id":{"anyOf":[{"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)$"},{"type":"null"}]},"period":{"type":"string","enum":["day","week","month","total"]},"hard_cap_cents":{"type":"integer","minimum":0,"maximum":9007199254740991},"soft_alert_pct":{"type":"integer","minimum":1,"maximum":100},"on_exceed":{"type":"string","enum":["block","approval"]},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"active":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"scope_name":{"type":["string","null"]},"period_start":{"type":["string","null"]},"reserved_cents":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","org_id","scope_type","scope_id","period","hard_cap_cents","soft_alert_pct","on_exceed","currency","active","created_at","updated_at","scope_name","period_start","reserved_cents"]}},"required":["budget"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/hub/connections":{"get":{"operationId":"listHubConnections","tags":["Hub"],"summary":"The organization's connections (metadata only)","description":"Signed-in session only.","security":[{"session":[]}],"parameters":[{"name":"org_id","in":"query","required":false,"description":"The organization (sessions only; an API key always acts for its own org).","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":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"connections":{"type":"array","items":{"type":"object","properties":{"id":{"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)$"},"contract_id":{"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)$"},"contract_title":{"type":"string"},"provider":{"type":"string"},"method":{"type":"string","enum":["partner","oauth","handoff","api_key","vaulted"]},"display_name":{"type":"string"},"status":{"type":"string","enum":["pending","verifying","connected","expiring","revoked","failed"]},"scopes":{"type":"array","items":{"type":"string"}},"expires_at":{"type":["string","null"]},"last_used_at":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","contract_id","contract_title","provider","method","display_name","status","scopes","expires_at","last_used_at","created_at"]}}},"required":["connections"]}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"webhooks":{"approval.requested":{"post":{"summary":"approval.requested event","description":"Signed with your endpoint's secret: MYA-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of \"<t>.<raw body>\">. Answer 2xx within the timeout; anything else is retried with exponential backoff.","parameters":[{"name":"MYA-Signature","in":"header","required":true,"schema":{"type":"string"}},{"name":"MYA-Event","in":"header","required":true,"schema":{"type":"string","const":"approval.requested"}},{"name":"MYA-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","type","created_at","org_id","data"],"properties":{"id":{"type":"string","format":"uuid"},"type":{"const":"approval.requested"},"created_at":{"type":"string","format":"date-time"},"org_id":{"type":"string","format":"uuid"},"data":{"type":"object","properties":{"approval_id":{"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)$"},"contract_id":{"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)$"},"tool_key":{"type":"string"},"risk_class":{"type":"string"},"summary":{"type":"string"},"expires_at":{"anyOf":[{"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)))$"},{"type":"null"}]}},"required":["approval_id","contract_id","tool_key","risk_class","summary","expires_at"]}}}}}},"responses":{"200":{"description":"Received"}}}},"deliverable.ready":{"post":{"summary":"deliverable.ready event","description":"Signed with your endpoint's secret: MYA-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of \"<t>.<raw body>\">. Answer 2xx within the timeout; anything else is retried with exponential backoff.","parameters":[{"name":"MYA-Signature","in":"header","required":true,"schema":{"type":"string"}},{"name":"MYA-Event","in":"header","required":true,"schema":{"type":"string","const":"deliverable.ready"}},{"name":"MYA-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","type","created_at","org_id","data"],"properties":{"id":{"type":"string","format":"uuid"},"type":{"const":"deliverable.ready"},"created_at":{"type":"string","format":"date-time"},"org_id":{"type":"string","format":"uuid"},"data":{"type":"object","properties":{"deliverable_id":{"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)$"},"contract_id":{"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)$"},"task_id":{"anyOf":[{"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)$"},{"type":"null"}]},"type":{"type":"string"},"title":{"type":"string"},"version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"status":{"type":"string","enum":["pending_approval","delivered"]}},"required":["deliverable_id","contract_id","task_id","type","title","version","status"]}}}}}},"responses":{"200":{"description":"Received"}}}},"contract.status_changed":{"post":{"summary":"contract.status_changed event","description":"Signed with your endpoint's secret: MYA-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of \"<t>.<raw body>\">. Answer 2xx within the timeout; anything else is retried with exponential backoff.","parameters":[{"name":"MYA-Signature","in":"header","required":true,"schema":{"type":"string"}},{"name":"MYA-Event","in":"header","required":true,"schema":{"type":"string","const":"contract.status_changed"}},{"name":"MYA-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","type","created_at","org_id","data"],"properties":{"id":{"type":"string","format":"uuid"},"type":{"const":"contract.status_changed"},"created_at":{"type":"string","format":"date-time"},"org_id":{"type":"string","format":"uuid"},"data":{"type":"object","properties":{"contract_id":{"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)$"},"title":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"}},"required":["contract_id","title","from","to"]}}}}}},"responses":{"200":{"description":"Received"}}}},"report.ready":{"post":{"summary":"report.ready event","description":"Signed with your endpoint's secret: MYA-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of \"<t>.<raw body>\">. Answer 2xx within the timeout; anything else is retried with exponential backoff.","parameters":[{"name":"MYA-Signature","in":"header","required":true,"schema":{"type":"string"}},{"name":"MYA-Event","in":"header","required":true,"schema":{"type":"string","const":"report.ready"}},{"name":"MYA-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","type","created_at","org_id","data"],"properties":{"id":{"type":"string","format":"uuid"},"type":{"const":"report.ready"},"created_at":{"type":"string","format":"date-time"},"org_id":{"type":"string","format":"uuid"},"data":{"type":"object","properties":{"report_id":{"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)$"},"contract_id":{"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)$"},"period_start":{"type":"string","format":"date","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])))$"},"period_end":{"type":"string","format":"date","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])))$"}},"required":["report_id","contract_id","period_start","period_end"]}}}}}},"responses":{"200":{"description":"Received"}}}},"connection.expiring":{"post":{"summary":"connection.expiring event","description":"Signed with your endpoint's secret: MYA-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of \"<t>.<raw body>\">. Answer 2xx within the timeout; anything else is retried with exponential backoff.","parameters":[{"name":"MYA-Signature","in":"header","required":true,"schema":{"type":"string"}},{"name":"MYA-Event","in":"header","required":true,"schema":{"type":"string","const":"connection.expiring"}},{"name":"MYA-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","type","created_at","org_id","data"],"properties":{"id":{"type":"string","format":"uuid"},"type":{"const":"connection.expiring"},"created_at":{"type":"string","format":"date-time"},"org_id":{"type":"string","format":"uuid"},"data":{"type":"object","properties":{"connection_id":{"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)$"},"contract_id":{"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)$"},"provider":{"type":"string"},"display_name":{"type":"string"},"expires_at":{"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)))$"}},"required":["connection_id","contract_id","provider","display_name","expires_at"]}}}}}},"responses":{"200":{"description":"Received"}}}},"contract.closed":{"post":{"summary":"contract.closed event","description":"Signed with your endpoint's secret: MYA-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of \"<t>.<raw body>\">. Answer 2xx within the timeout; anything else is retried with exponential backoff.","parameters":[{"name":"MYA-Signature","in":"header","required":true,"schema":{"type":"string"}},{"name":"MYA-Event","in":"header","required":true,"schema":{"type":"string","const":"contract.closed"}},{"name":"MYA-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","type","created_at","org_id","data"],"properties":{"id":{"type":"string","format":"uuid"},"type":{"const":"contract.closed"},"created_at":{"type":"string","format":"date-time"},"org_id":{"type":"string","format":"uuid"},"data":{"type":"object","properties":{"contract_id":{"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)$"},"title":{"type":"string"},"closed_at":{"anyOf":[{"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)))$"},{"type":"null"}]},"certificate_id":{"anyOf":[{"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)$"},{"type":"null"}]},"certificate_url":{"type":["string","null"]}},"required":["contract_id","title","closed_at","certificate_id","certificate_url"]}}}}}},"responses":{"200":{"description":"Received"}}}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"mya_live_…","description":"Organization API key (Business plan and up)."},"session":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"A signed-in session's access token (the web app)."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["auth_required","step_up_required","forbidden","not_found","plan_limit","validation","approval_required","contract_inactive","connection_missing","rate_limited","vault_unavailable","billing_unavailable","model_unavailable","queue_unavailable","two_person_required","conflict","provider_unavailable","budget_exceeded","internal"]},"message":{"type":"string"},"details":{},"request_id":{"type":"string"}},"required":["code","message","request_id"]}},"required":["error"],"x-codes":["auth_required","step_up_required","forbidden","not_found","plan_limit","validation","approval_required","contract_inactive","connection_missing","rate_limited","vault_unavailable","billing_unavailable","model_unavailable","queue_unavailable","two_person_required","conflict","provider_unavailable","budget_exceeded","internal"]}}}}