{"openapi":"3.1.0","info":{"title":"TokenObserve Cloud Management API","version":"1.0.0","description":"Managed verified human Bearer tokens or portal cookies. Cookie mutations require exact Origin and x-acp-cloud-csrf. Child human APIs use the same Bearer identity at /w/{workspaceId}/api/* and enforce their own role/team authorization. Gateway and MCP endpoints require workspace agent/seat keys, never managed user tokens."},"servers":[{"url":"https://tokenobserve-cloud-production.up.railway.app"}],"paths":{"/api/cloud/discovery":{"get":{"operationId":"discoverCloud","description":"Public managed Auth and workspace endpoint discovery.","security":[],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/openapi.json":{"get":{"operationId":"cloudOpenApi","description":"This management API document.","security":[],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/capabilities":{"get":{"operationId":"providerCapabilities","description":"Provider billing credential requirements, exclusions and documentation.","security":[],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/signup":{"post":{"operationId":"signup","description":"Portal bootstrap only: exact Origin required. Signup requires email confirmation; sign-in sets cookies. Headless clients use managed Auth directly.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","minLength":3,"maxLength":320},"password":{"type":"string","minLength":12,"maxLength":1024}},"required":["email","password"]}}}},"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/signin":{"post":{"operationId":"signin","description":"Portal bootstrap only: exact Origin required. Signup requires email confirmation; sign-in sets cookies. Headless clients use managed Auth directly.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","minLength":3,"maxLength":320},"password":{"type":"string","minLength":1,"maxLength":1024}},"required":["email","password"]}}}},"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/recover":{"post":{"operationId":"recover","description":"Portal email assistance; exact Origin required, generic account-independent response.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","minLength":3,"maxLength":320}},"required":["email"]}}}},"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/resend":{"post":{"operationId":"resend","description":"Portal email assistance; exact Origin required, generic account-independent response.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","minLength":3,"maxLength":320}},"required":["email"]}}}},"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/session":{"post":{"operationId":"createPortalSession","description":"Exchange a verified managed user token for portal cookies; exact Origin required.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"accessToken":{"type":"string","minLength":20,"maxLength":8192}},"required":["accessToken"]}}}},"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/logout":{"post":{"operationId":"endPortalSession","description":"Ends a portal session with Origin and CSRF. Headless clients end Bearer sessions through managed Auth logout.","security":[{"portalSession":[]}],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/password":{"post":{"operationId":"changePassword","description":"Managed Auth password update for the verified named user; invalidates cloud portal sessions and requires normal sign-in.","security":[{"managedUser":[]},{"portalSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"password":{"type":"string","minLength":12,"maxLength":1024}},"required":["password"]}}}},"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/me":{"get":{"operationId":"getCurrentUser","description":"Verified human identity, memberships and observed shared service quotas. Cookie sessions also return csrf.","security":[{"managedUser":[]},{"portalSession":[]}],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/workspaces":{"post":{"operationId":"createWorkspace","description":"Creates an isolated application workspace for the verified human, subject to workspace and storage limits. Inspect returned state; error means runtime provisioning failed.","security":[{"managedUser":[]},{"portalSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":80}},"required":["name"]}}}},"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/workspaces/{workspaceId}/connections":{"get":{"operationId":"listConnections","description":"Membership required. Secret-free billing and inference settings and gateway URLs.","security":[{"managedUser":[]},{"portalSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","pattern":"^ws_[a-f0-9]{32}$"}}],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"connectBilling","description":"Administrator and active trial required. Saves separate billing credentials and attempts collection; inspect returned connection.status, then report freshness/coverage.","security":[{"managedUser":[]},{"portalSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"provider":{"type":"string","enum":["openai","anthropic","xai","google"]},"name":{"type":"string","minLength":1,"maxLength":80},"config":{"type":"object"},"secret":{"type":"string","minLength":10,"maxLength":32768,"writeOnly":true}},"required":["provider","name","secret"]}}}},"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","pattern":"^ws_[a-f0-9]{32}$"}}],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/workspaces/{workspaceId}/connections/{connectionId}/sync":{"post":{"operationId":"syncBilling","description":"Administrator and active trial required. Explicitly refreshes provider-reported costs; bounded collection capacity.","security":[{"managedUser":[]},{"portalSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","pattern":"^ws_[a-f0-9]{32}$"}},{"name":"connectionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/workspaces/{workspaceId}/connections/{connectionId}":{"patch":{"operationId":"rotateBillingCredential","description":"Administrator and active trial required. Explicitly assert the same provider account; replace only the encrypted credential and attempt one refresh, retaining account history/configuration. Inspect status and report freshness. Different accounts require disconnecting first.","security":[{"managedUser":[]},{"portalSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"secret":{"type":"string","minLength":10,"maxLength":32768,"writeOnly":true},"confirmSameAccount":{"const":true}},"required":["secret","confirmSameAccount"]}}}},"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","pattern":"^ws_[a-f0-9]{32}$"}},{"name":"connectionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"disconnectBilling","description":"Administrator and active trial required. Removes the connection and its billing rows.","security":[{"managedUser":[]},{"portalSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","pattern":"^ws_[a-f0-9]{32}$"}},{"name":"connectionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/workspaces/{workspaceId}/inference":{"post":{"operationId":"connectInference","description":"Administrator and active trial required. Saves separate inference credentials and prepares roles/providers without sending a model request.","security":[{"managedUser":[]},{"portalSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"provider":{"type":"string","enum":["openai","anthropic","xai","google"]},"key":{"type":"string","minLength":10,"maxLength":4096,"writeOnly":true},"model":{"type":"string","minLength":1,"maxLength":120},"capture":{"type":"string","enum":["metadata","redacted"],"default":"metadata"}},"required":["provider","key","model"]}}}},"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","pattern":"^ws_[a-f0-9]{32}$"}}],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"disconnectInference","description":"Administrator and active trial required. Clears inference settings.","security":[{"managedUser":[]},{"portalSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","pattern":"^ws_[a-f0-9]{32}$"}}],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/workspaces/{workspaceId}/spend":{"get":{"operationId":"legacySpend","description":"Compatibility endpoint: latest 30 complete UTC days, bounded to 10,000 rows. Prefer spend/report for pagination.","security":[{"managedUser":[]},{"portalSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","pattern":"^ws_[a-f0-9]{32}$"}}],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/workspaces/{workspaceId}/spend/export":{"get":{"operationId":"legacySpendExport","description":"Compatibility all-retained CSV, bounded to 10,000 rows. Prefer spend/report.csv for larger exports.","security":[{"managedUser":[]},{"portalSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","pattern":"^ws_[a-f0-9]{32}$"}}],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/workspaces/{workspaceId}/spend/report":{"get":{"operationId":"getProviderBillingReport","description":"Workspace-wide provider account costs. Totals cover the entire matched query, never just this page. All four source states are included. Missing evidence is unknown spend; currencies remain separate.","security":[{"managedUser":[]},{"portalSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","pattern":"^ws_[a-f0-9]{32}$"}},{"name":"since","in":"query","schema":{"type":"string","format":"date-time"},"description":"Inclusive UTC midnight; defaults to 30 days before until."},{"name":"until","in":"query","schema":{"type":"string","format":"date-time"},"description":"Exclusive UTC midnight no later than today; at most 366 days after since."},{"name":"provider","in":"query","schema":{"type":"string","enum":["openai","anthropic","xai","google"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":2048},"description":"Opaque workspace/query/revision-bound cursor. Keep every query parameter fixed; 409 means restart the report."}],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderBillingReport"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/workspaces/{workspaceId}/spend/report.csv":{"get":{"operationId":"exportProviderBillingPage","description":"One CSV page of the same report query. Follow X-Next-Cursor until empty; omit later page headers when combining files. Query over 100,000 rows fails closed; split into disjoint windows.","security":[{"managedUser":[]},{"portalSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","pattern":"^ws_[a-f0-9]{32}$"}},{"name":"since","in":"query","schema":{"type":"string","format":"date-time"},"description":"Inclusive UTC midnight; defaults to 30 days before until."},{"name":"until","in":"query","schema":{"type":"string","format":"date-time"},"description":"Exclusive UTC midnight no later than today; at most 366 days after since."},{"name":"provider","in":"query","schema":{"type":"string","enum":["openai","anthropic","xai","google"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":2048},"description":"Opaque workspace/query/revision-bound cursor. Keep every query parameter fixed; 409 means restart the report."}],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}},"X-Next-Cursor":{"schema":{"type":"string"}},"X-Total-Rows":{"schema":{"type":"integer"}}},"content":{"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/cloud/workspaces/{workspaceId}/spend/report/full.csv":{"get":{"operationId":"exportProviderBillingFullPeriod","description":"One complete CSV for the selected period/provider from a single consistent database snapshot. No cursor accepted. Bounded to 100,000 rows and 20 MiB; failure returns no partial CSV. Verify Content-Digest against response bytes and retain JSON report source coverage separately.","security":[{"managedUser":[]},{"portalSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","pattern":"^ws_[a-f0-9]{32}$"}},{"name":"since","in":"query","schema":{"type":"string","format":"date-time"},"description":"Inclusive UTC midnight; defaults to 30 days before until."},{"name":"until","in":"query","schema":{"type":"string","format":"date-time"},"description":"Exclusive UTC midnight no later than today; at most 366 days after since."},{"name":"provider","in":"query","schema":{"type":"string","enum":["openai","anthropic","xai","google"]}}],"responses":{"200":{"description":"Success","headers":{"X-Request-Id":{"schema":{"type":"string"}},"X-Total-Rows":{"schema":{"type":"integer"}},"X-Billing-Completeness":{"schema":{"type":"string","enum":["true","false"]}},"X-Report-Since":{"schema":{"type":"string"}},"X-Report-Until":{"schema":{"type":"string"}},"Content-Digest":{"schema":{"type":"string"},"description":"sha-256=:BASE64_SHA256:"}},"content":{"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or traffic quota exceeded; Retry-After is seconds.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Typed refusal; workspace existence is hidden from nonmembers.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"managedUser":{"type":"http","scheme":"bearer","bearerFormat":"Supabase managed user access token"},"portalSession":{"type":"apiKey","in":"cookie","name":"acp_cloud_session"}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"retryable":{"type":"boolean"}}}}},"ProviderBillingReport":{"type":"object","required":["generatedAt","workspaceId","scope","basis","window","provider","totals","rows","sources","pagination","truncated","completeness","notice"],"properties":{"generatedAt":{"type":"string","format":"date-time"},"workspaceId":{"type":"string"},"scope":{"const":"provider_account"},"basis":{"const":"provider_reported_cost"},"window":{"type":"object","required":["since","until"],"properties":{"since":{"type":"string"},"until":{"type":"string"}}},"provider":{"type":["string","null"],"enum":["openai","anthropic","xai","google",null]},"totals":{"type":"array","items":{"type":"object","required":["currency","amount","rowCount"],"properties":{"currency":{"type":"string"},"amount":{"type":"string","description":"Exact decimal string; do not parse as binary floating point."},"rowCount":{"type":"integer"}}}},"rows":{"type":"array","items":{"type":"object","required":["externalId","connectionId","provider","periodStart","periodEnd","currency","amount","dimensions"],"properties":{"externalId":{"type":"string"},"connectionId":{"type":"string"},"provider":{"type":"string","enum":["openai","anthropic","xai","google"]},"periodStart":{"type":"string"},"periodEnd":{"type":"string"},"currency":{"type":"string"},"amount":{"type":"string"},"dimensions":{"type":"object","additionalProperties":{"type":["string","null"]}}}}},"sources":{"type":"array","minItems":4,"maxItems":4,"items":{"type":"object","required":["provider","connectionId","name","status","lastCollectedAt","freshness","collectionWindow","coverage","reasons","notice"],"properties":{"provider":{"type":"string","enum":["openai","anthropic","xai","google"]},"connectionId":{"type":["string","null"]},"name":{"type":["string","null"]},"status":{"enum":["disconnected","pending","connected","error"]},"lastCollectedAt":{"type":["string","null"]},"freshness":{"enum":["fresh","stale","unknown"]},"collectionWindow":{"type":["object","null"],"properties":{"since":{"type":"string"},"until":{"type":"string"}}},"coverage":{"enum":["complete","partial","unknown"]},"reasons":{"type":"array","items":{"type":"string"}},"notice":{"type":"string"}}}},"pagination":{"type":"object","required":["limit","totalRows","nextCursor"],"properties":{"limit":{"type":"integer"},"totalRows":{"type":"integer"},"nextCursor":{"type":["string","null"]}}},"truncated":{"type":"boolean"},"completeness":{"type":"object","required":["complete","reasons"],"properties":{"complete":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}}}},"notice":{"type":"string"}}}}}}