{"info":{"title":"Context OS API","version":"1.0.0","description":"Permissioned Source catalogue, read-only SQL, grants, and content-free operational activity."},"servers":[{"url":"https://platform.trycombined.com","description":"Current Context OS deployment"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"WorkOS access token, Agent Registration credential, or API key"}},"schemas":{"ApiError":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","correlationId"],"properties":{"code":{"type":"string","examples":["bad_request","query_rejected","rate_limited"],"description":"Stable machine-readable issue or error code."},"message":{"type":"string","description":"Human-readable issue or error explanation safe for the caller."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."},"details":{"type":"object","additionalProperties":true,"description":"Optional structured diagnostic details; shape depends on the error code."}},"description":"Structured API error envelope."}}}}},"openapi":"3.1.1","paths":{"/v1/accounts":{"get":{"operationId":"listAccounts","summary":"List Accounts","description":"List accounts visible to the authenticated principal.","tags":["Accounts"],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,62}$","description":"Stable URL-safe Account slug."},"name":{"type":"string","minLength":1,"maxLength":300,"description":"Human-readable resource, principal, column, or type name."},"state":{"enum":["active","suspended","deleting","deleted"],"type":"string","description":"Current lifecycle or execution state of the represented resource."},"sourceCounts":{"type":"object","propertyNames":{"enum":["healthy","syncing","needs_authorization","needs_review","paused","failed","deleting","deleted"],"type":"string"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Source counts grouped by lifecycle state."},"desktopReady":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of Desktop installations currently ready to capture."},"desktopTotal":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Total Desktop installations associated with the Account."},"pendingAuthorizations":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of incomplete Source authorization requests for the Account."},"stalestExpectedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Earliest expected freshness deadline among the Account's active Sources."},"issue":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":160,"description":"Stable machine-readable issue or error code."},"message":{"type":"string","minLength":1,"maxLength":1000,"description":"Human-readable issue or error explanation safe for the caller."},"action":{"anyOf":[{"type":"string","minLength":1,"maxLength":300},{"type":"null"}],"description":"Stable operational action name recorded by Activity."}},"required":["code","message","action"],"additionalProperties":false},{"type":"null"}],"description":"Current content-free issue and recommended action, or null."},"lastActivityAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time of the Account's latest operational activity."}},"required":["id","slug","name","state","sourceCounts","desktopReady","desktopTotal","pendingAuthorizations","stalestExpectedAt","issue","lastActivityAt"],"additionalProperties":false},"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/catalog":{"get":{"operationId":"listCatalog","summary":"List Catalog","description":"Discover granted Sources, datasets, fields, logical SQL names, and freshness before querying.","tags":["Catalogue"],"parameters":[{"name":"accountId","in":"query","required":true,"schema":{"type":"string","format":"uuid"},"allowEmptyValue":true,"allowReserved":true,"description":"Account UUID that defines the tenant and authorization scope.","example":"00000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"name":{"type":"string","minLength":1,"maxLength":300,"description":"Human-readable resource, principal, column, or type name."},"connectorKey":{"type":"string","description":"Stable key of the connector definition used by the Source."},"state":{"enum":["healthy","syncing","needs_authorization","needs_review","paused","failed","deleting","deleted"],"type":"string","description":"Current lifecycle or execution state of the represented resource."},"lastSuccessAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time of the latest successfully committed snapshot."},"logicalName":{"type":"string","minLength":1,"maxLength":63,"description":"Stable logical name exposed to SQL clients."},"datasets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"sourceId":{"type":"string","format":"uuid","description":"Source UUID within the Account scope."},"logicalSchema":{"type":"string","minLength":1,"maxLength":255,"description":"Logical SQL schema containing the dataset relation."},"logicalTable":{"type":"string","minLength":1,"maxLength":255,"description":"Logical SQL table name for the dataset relation."},"lastSuccessAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time of the latest successfully committed snapshot."},"fields":{"type":"array","items":{"type":"object","properties":{"logicalName":{"type":"string","minLength":1,"maxLength":255,"description":"Stable logical name exposed to SQL clients."},"duckdbType":{"type":"string","minLength":1,"maxLength":255,"description":"DuckDB logical type exposed for this catalogue field."},"nullable":{"type":"boolean","description":"Whether the catalogue field may contain null values."},"classification":{"enum":["public","internal","confidential","restricted"],"type":"string","description":"Governance classification assigned to the discovered field."},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"description":"Human-readable explanation of the connector, field, or resource."}},"required":["logicalName","duckdbType","nullable","classification","description"],"additionalProperties":false},"description":"Discovered or catalogue fields belonging to the dataset."}},"required":["id","sourceId","logicalSchema","logicalTable","lastSuccessAt","fields"],"additionalProperties":false},"description":"Datasets visible within the returned granted Source scope."}},"required":["id","name","connectorKey","state","lastSuccessAt","logicalName","datasets"],"additionalProperties":false},"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/sql":{"post":{"operationId":"querySql","summary":"Query Sql","description":"Execute one bounded, read-only SELECT over granted catalog relations. Use positional parameters for values and maxRows to bound output. An optional Idempotency-Key can recover the identical query after an ambiguous transport failure.","tags":["Query"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"sql":{"type":"string","minLength":1,"maxLength":16384,"description":"One bounded, read-only SELECT using logical catalog relation names."},"parameters":{"type":"array","maxItems":100,"items":{"anyOf":[{"type":"string","maxLength":16384},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"default":[],"description":"Positional values for SQL ? placeholders, in order."},"maxRows":{"type":"integer","minimum":1,"maximum":10000,"default":1000,"description":"Hard maximum number of rows returned by the query."},"idempotencyKey":{"type":"string","minLength":8,"maxLength":200,"description":"Client-generated key reused only with the identical request body."}},"required":["accountId","sql"],"additionalProperties":false},"example":{"accountId":"00000000-0000-4000-8000-000000000001","sql":"SELECT channel_name, COUNT(*) AS messages FROM slack_messages WHERE sent_at >= ? GROUP BY channel_name ORDER BY messages DESC LIMIT 20","parameters":["2026-08-01T00:00:00Z"],"maxRows":20}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"receiptId":{"type":"string","format":"uuid","description":"Query receipt UUID used for content-free audit status."},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Human-readable resource, principal, column, or type name."},"type":{"type":"string","description":"Logical column type or content-free Activity resource type."}},"required":["name","type"]},"description":"Ordered names and logical types returned by the SQL query."},"rows":{"type":"array","maxItems":10000,"items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"description":"Typed result rows authorized and returned by the query."},"rowCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of rows returned in this query result."},"truncated":{"type":"boolean","description":"Whether an enforced row bound omitted additional result rows."},"durationMs":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Elapsed operation duration in milliseconds, when available."},"estimatedInputBytes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Estimated input bytes scanned by the completed query."},"grantVersion":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0,"description":"Account authorization version evaluated for this operation or revocation."}},"required":["receiptId","columns","rows","rowCount","truncated","durationMs","estimatedInputBytes","grantVersion"],"additionalProperties":false,"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"408":{"description":"Query execution was canceled or exceeded its execution deadline.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"query_timeout","message":"Query execution was canceled or exceeded its execution deadline.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","required":false,"description":"Optional recovery key. Reuse it only with the identical SQL request body.","schema":{"type":"string","minLength":8,"maxLength":200},"example":"operation-20260816-001"}]}},"/v1/query-receipts/{receiptId}":{"get":{"operationId":"getQueryReceipt","summary":"Get Query Receipt","description":"Return the audit receipt for a prior query without returning query result content.","tags":["Query"],"parameters":[{"name":"receiptId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Query receipt UUID used for content-free audit status.","example":"00000000-0000-4000-8000-000000000006"},{"name":"accountId","in":"query","required":true,"schema":{"type":"string","format":"uuid"},"allowEmptyValue":true,"allowReserved":true,"description":"Account UUID that defines the tenant and authorization scope.","example":"00000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"principalId":{"type":"string","format":"uuid","description":"Human, agent, FDE, or service principal UUID."},"canonicalSqlHash":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"SHA-256 hash of canonical SQL retained without storing result content."},"sourceIds":{"type":"array","maxItems":8,"items":{"type":"string","format":"uuid"},"description":"Source UUIDs within the Account scope."},"datasetIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Dataset UUIDs within the granted Source scope."},"grantVersionStart":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0,"description":"Authorization version recorded when query execution began."},"grantVersionEnd":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0},{"type":"null"}],"description":"Authorization version checked before returning query results, when reached."},"state":{"enum":["queued","running","succeeded","denied","failed","timed_out","revoked","canceled"],"type":"string","description":"Current lifecycle or execution state of the represented resource."},"rows":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Typed result rows authorized and returned by the query."},"truncated":{"type":"boolean","description":"Whether an enforced row bound omitted additional result rows."},"estimatedBytes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Estimated bytes scanned by the recorded query, when known."},"durationMs":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Elapsed operation duration in milliseconds, when available."},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Stable failure code recorded for an attempt or query receipt."},"createdAt":{"type":"string","format":"date-time","description":"ISO 8601 creation time of this resource or event."},"finishedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 completion time, or null while unfinished."}},"required":["id","accountId","principalId","canonicalSqlHash","sourceIds","datasetIds","grantVersionStart","grantVersionEnd","state","rows","truncated","estimatedBytes","durationMs","errorCode","createdAt","finishedAt"],"additionalProperties":false,"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/connector-definitions":{"get":{"operationId":"listConnectorDefinitions","summary":"List Connector Definitions","description":"List connector types and the configuration fields required to create Sources.","tags":["Sources"],"parameters":[{"name":"support","in":"query","schema":{"enum":["ready","preview","planned"],"type":"string"},"allowEmptyValue":true,"allowReserved":true,"description":"Connector availability level: ready, preview, or planned.","example":"ready"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","pattern":"^[a-z0-9][a-z0-9._-]{0,127}$","description":"Stable connector key used in API and Source configuration."},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0,"description":"Positive connector, dataset, or schema revision number."},"name":{"type":"string","minLength":1,"maxLength":160,"description":"Human-readable resource, principal, column, or type name."},"description":{"type":"string","maxLength":1000,"description":"Human-readable explanation of the connector, field, or resource."},"category":{"type":"string","minLength":1,"maxLength":100,"description":"Human-readable connector catalogue category."},"logoPath":{"type":"string","minLength":1,"maxLength":500,"description":"Public path of the connector logo asset."},"support":{"enum":["ready","preview","planned"],"type":"string","description":"Connector availability level: ready, preview, or planned."},"authorizationType":{"enum":["oauth2","credentials","enrollment"],"type":"string","description":"Connector authorization mechanism: OAuth, credentials, or enrollment."},"credentialSchema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"JSON Schema describing configuration fields for this connector revision."},"capabilities":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"description":"Connector operations supported by this definition revision."},"knownLimits":{"type":"array","items":{"type":"string","minLength":1,"maxLength":300},"description":"Documented operational constraints for this connector revision."}},"required":["key","revision","name","description","category","logoPath","support","authorizationType","credentialSchema","capabilities","knownLimits"],"additionalProperties":false},"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/source-authorization-requests":{"post":{"operationId":"createSourceAuthorizationRequest","summary":"Create Source Authorization Request","description":"Create a time-bounded request for a human to authorize access to a Source.","tags":["Sources"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"connectorKey":{"type":"string","minLength":1,"maxLength":127,"description":"Stable key of the connector definition used by the Source."},"recipientEmail":{"type":"string","format":"email","description":"Email address of the intended Source authorizer."},"idempotencyKey":{"type":"string","minLength":8,"maxLength":200,"description":"Client-generated key reused only with the identical request body."}},"required":["accountId","connectorKey","recipientEmail"]},"example":{"accountId":"00000000-0000-4000-8000-000000000001","connectorKey":"slack","recipientEmail":"owner@example.com"}}}},"responses":{"202":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","description":"Source authorization request UUID."},"sourceId":{"type":"string","format":"uuid","description":"Source UUID within the Account scope."},"authorizationUrl":{"type":"string","format":"uri","description":"Time-bounded URL the intended recipient opens to authorize the Source."},"delivery":{"enum":["sent","failed","not_configured"],"type":"string","description":"Authorization-request email delivery status."},"expiresAt":{"type":"string","format":"date-time","description":"Optional ISO 8601 expiry; null means no scheduled expiry."}},"required":["requestId","sourceId","authorizationUrl","delivery","expiresAt"],"additionalProperties":false,"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"description":"Unique key for this mutation and request body.","schema":{"type":"string","minLength":8,"maxLength":200},"example":"operation-20260816-001"}]}},"/v1/source-authorization-requests/{requestId}":{"get":{"operationId":"getSourceAuthorizationRequest","summary":"Get Source Authorization Request","description":"Return the state and expiry of one Source authorization request.","tags":["Sources"],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Source authorization request UUID.","example":"00000000-0000-4000-8000-000000000008"},{"name":"accountId","in":"query","required":true,"schema":{"type":"string","format":"uuid"},"allowEmptyValue":true,"allowReserved":true,"description":"Account UUID that defines the tenant and authorization scope.","example":"00000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","description":"Source authorization request UUID."},"sourceId":{"type":"string","format":"uuid","description":"Source UUID within the Account scope."},"state":{"enum":["pending","opened","completed","expired","revoked"],"type":"string","description":"Current lifecycle or execution state of the represented resource."},"expiresAt":{"type":"string","format":"date-time","description":"Optional ISO 8601 expiry; null means no scheduled expiry."},"discoveryJobId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Discovery job UUID created after Source authorization."},"discoveryState":{"anyOf":[{"enum":["queued","running","succeeded","failed"],"type":"string"},{"type":"null"}],"description":"Current queued, running, succeeded, or failed discovery state."},"discoveryError":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"description":"Content-free discovery failure summary, or null when none is recorded."}},"required":["requestId","sourceId","state","expiresAt","discoveryJobId","discoveryState","discoveryError"],"additionalProperties":false,"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/sources":{"get":{"operationId":"listSources","summary":"List Sources","description":"List granted Sources and their current lifecycle state.","tags":["Sources"],"parameters":[{"name":"accountId","in":"query","required":true,"schema":{"type":"string","format":"uuid"},"allowEmptyValue":true,"allowReserved":true,"description":"Account UUID that defines the tenant and authorization scope.","example":"00000000-0000-4000-8000-000000000001"},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":1024},"allowEmptyValue":true,"allowReserved":true,"description":"Opaque cursor returned by the preceding list response.","example":"eyJvZmZzZXQiOjUwfQ"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"allowEmptyValue":true,"allowReserved":true,"description":"Maximum number of items to return in this page.","example":50},{"name":"query","in":"query","required":false,"schema":{"type":"string","maxLength":300},"allowEmptyValue":true,"allowReserved":true,"description":"Optional case-insensitive text filter for this collection.","example":"Slack"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"kind":{"enum":["desktop","saas"],"type":"string","description":"Principal or Source kind represented by this object."},"connectorKey":{"type":"string","description":"Stable key of the connector definition used by the Source."},"name":{"type":"string","minLength":1,"maxLength":300,"description":"Human-readable resource, principal, column, or type name."},"state":{"enum":["healthy","syncing","needs_authorization","needs_review","paused","failed","deleting","deleted"],"type":"string","description":"Current lifecycle or execution state of the represented resource."},"owner":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"UUID or stable identifier of the represented resource."},"name":{"type":"string","description":"Human-readable resource, principal, column, or type name."},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"description":"Principal or Source owner email address, when visible."}},"required":["id","name","email"],"additionalProperties":false},{"type":"null"}],"description":"Visible Source owner summary, or null when unassigned."},"datasetCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of datasets currently associated with the Source."},"endpointCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of Desktop endpoints associated with the Source."},"lastSuccessAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time of the latest successfully committed snapshot."},"issue":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":160,"description":"Stable machine-readable issue or error code."},"message":{"type":"string","minLength":1,"maxLength":1000,"description":"Human-readable issue or error explanation safe for the caller."},"action":{"anyOf":[{"type":"string","minLength":1,"maxLength":300},{"type":"null"}],"description":"Stable operational action name recorded by Activity."}},"required":["code","message","action"],"additionalProperties":false},{"type":"null"}],"description":"Current content-free issue and recommended action, or null."},"schedule":{"enum":["manual","daily","hourly"],"type":"string","description":"Manual, daily, or hourly Source ingestion schedule."},"stats":{"type":"array","maxItems":7,"items":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"UTC calendar date represented by the daily Source statistic."},"records":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records processed by an attempt or on a UTC date."},"errors":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of failed records or observations for this UTC date."},"bytes":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Uncompressed bytes processed by the attempt or daily Source statistic."}},"required":["date","records","errors","bytes"],"additionalProperties":false},"description":"Up to seven UTC daily record, error, and byte Source statistics."}},"required":["id","accountId","kind","connectorKey","name","state","owner","datasetCount","endpointCount","lastSuccessAt","issue","schedule","stats"],"additionalProperties":false},"description":"Operation result payload authorized for the current principal."},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}],"description":"Opaque cursor for the next page, or null when complete."},"hasMore":{"type":"boolean","description":"Whether another list page is available after this response."}},"required":["nextCursor","hasMore"],"additionalProperties":false,"description":"Cursor pagination metadata for this list response."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","page","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/sources/{sourceId}":{"get":{"operationId":"getSource","summary":"Get Source","description":"Return one granted Source and its current operational state.","tags":["Sources"],"parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Source UUID within the Account scope.","example":"00000000-0000-4000-8000-000000000002"},{"name":"accountId","in":"query","required":true,"schema":{"type":"string","format":"uuid"},"allowEmptyValue":true,"allowReserved":true,"description":"Account UUID that defines the tenant and authorization scope.","example":"00000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"source":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"kind":{"enum":["desktop","saas"],"type":"string","description":"Principal or Source kind represented by this object."},"connectorKey":{"type":"string","description":"Stable key of the connector definition used by the Source."},"name":{"type":"string","minLength":1,"maxLength":300,"description":"Human-readable resource, principal, column, or type name."},"state":{"enum":["healthy","syncing","needs_authorization","needs_review","paused","failed","deleting","deleted"],"type":"string","description":"Current lifecycle or execution state of the represented resource."},"owner":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"UUID or stable identifier of the represented resource."},"name":{"type":"string","description":"Human-readable resource, principal, column, or type name."},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"description":"Principal or Source owner email address, when visible."}},"required":["id","name","email"],"additionalProperties":false},{"type":"null"}],"description":"Visible Source owner summary, or null when unassigned."},"datasetCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of datasets currently associated with the Source."},"endpointCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of Desktop endpoints associated with the Source."},"lastSuccessAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time of the latest successfully committed snapshot."},"issue":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":160,"description":"Stable machine-readable issue or error code."},"message":{"type":"string","minLength":1,"maxLength":1000,"description":"Human-readable issue or error explanation safe for the caller."},"action":{"anyOf":[{"type":"string","minLength":1,"maxLength":300},{"type":"null"}],"description":"Stable operational action name recorded by Activity."}},"required":["code","message","action"],"additionalProperties":false},{"type":"null"}],"description":"Current content-free issue and recommended action, or null."},"schedule":{"enum":["manual","daily","hourly"],"type":"string","description":"Manual, daily, or hourly Source ingestion schedule."},"stats":{"type":"array","maxItems":7,"items":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"UTC calendar date represented by the daily Source statistic."},"records":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records processed by an attempt or on a UTC date."},"errors":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of failed records or observations for this UTC date."},"bytes":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Uncompressed bytes processed by the attempt or daily Source statistic."}},"required":["date","records","errors","bytes"],"additionalProperties":false},"description":"Up to seven UTC daily record, error, and byte Source statistics."}},"required":["id","accountId","kind","connectorKey","name","state","owner","datasetCount","endpointCount","lastSuccessAt","issue","schedule","stats"],"additionalProperties":false,"description":"Detailed summary of the selected Source."},"datasets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"sourceId":{"type":"string","format":"uuid","description":"Source UUID within the Account scope."},"namespace":{"type":"string","maxLength":300,"description":"Provider namespace from which the dataset was discovered."},"providerName":{"type":"string","minLength":1,"maxLength":500,"description":"Original provider name of the dataset or field."},"logicalSchema":{"type":"string","minLength":1,"maxLength":255,"description":"Logical SQL schema containing the dataset relation."},"logicalTable":{"type":"string","minLength":1,"maxLength":255,"description":"Logical SQL table name for the dataset relation."},"selected":{"type":"boolean","description":"Whether this dataset or field is selected for ingestion."},"syncMode":{"enum":["incremental_keyed","append_only","full_refresh"],"type":"string","description":"Incremental keyed, append-only, or full-refresh ingestion mode."},"cursorFieldIds":{"type":"array","items":{"type":"string"},"description":"Dataset field identifiers used to advance incremental ingestion."},"primaryKeyFieldIds":{"type":"array","items":{"type":"string"},"description":"Dataset fields that form its discovered primary key."},"selectedFieldIds":{"type":"array","items":{"type":"string"},"description":"Dataset fields selected for ingestion and query exposure."},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0,"description":"Positive connector, dataset, or schema revision number."},"state":{"enum":["healthy","syncing","needs_review","paused","failed"],"type":"string","description":"Current lifecycle or execution state of the represented resource."},"projectedRows":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Estimated rows for a selected dataset before ingestion."},"projectedBytes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Estimated bytes for a selected dataset before ingestion."},"lastSuccessAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time of the latest successfully committed snapshot."},"issue":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":160,"description":"Stable machine-readable issue or error code."},"message":{"type":"string","minLength":1,"maxLength":1000,"description":"Human-readable issue or error explanation safe for the caller."},"action":{"anyOf":[{"type":"string","minLength":1,"maxLength":300},{"type":"null"}],"description":"Stable operational action name recorded by Activity."}},"required":["code","message","action"],"additionalProperties":false},{"type":"null"}],"description":"Current content-free issue and recommended action, or null."},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":255,"description":"UUID or stable identifier of the represented resource."},"datasetId":{"type":"string","format":"uuid","description":"Dataset UUID within its Source and Account scope."},"ordinal":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Zero-based field position in the provider dataset."},"providerName":{"type":"string","minLength":1,"maxLength":500,"description":"Original provider name of the dataset or field."},"logicalName":{"type":"string","minLength":1,"maxLength":255,"description":"Stable logical name exposed to SQL clients."},"duckdbType":{"type":"string","minLength":1,"maxLength":255,"description":"DuckDB logical type exposed for this catalogue field."},"nullable":{"type":"boolean","description":"Whether the catalogue field may contain null values."},"selected":{"type":"boolean","description":"Whether this dataset or field is selected for ingestion."},"classification":{"enum":["public","internal","confidential","restricted"],"type":"string","description":"Governance classification assigned to the discovered field."},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"description":"Human-readable explanation of the connector, field, or resource."}},"required":["id","datasetId","ordinal","providerName","logicalName","duckdbType","nullable","selected","classification","description"],"additionalProperties":false},"description":"Discovered or catalogue fields belonging to the dataset."}},"required":["id","sourceId","namespace","providerName","logicalSchema","logicalTable","selected","syncMode","cursorFieldIds","primaryKeyFieldIds","selectedFieldIds","revision","state","projectedRows","projectedBytes","lastSuccessAt","issue"],"additionalProperties":false},"description":"Datasets visible within the returned granted Source scope."},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":255,"description":"UUID or stable identifier of the represented resource."},"datasetId":{"type":"string","format":"uuid","description":"Dataset UUID within its Source and Account scope."},"ordinal":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Zero-based field position in the provider dataset."},"providerName":{"type":"string","minLength":1,"maxLength":500,"description":"Original provider name of the dataset or field."},"logicalName":{"type":"string","minLength":1,"maxLength":255,"description":"Stable logical name exposed to SQL clients."},"duckdbType":{"type":"string","minLength":1,"maxLength":255,"description":"DuckDB logical type exposed for this catalogue field."},"nullable":{"type":"boolean","description":"Whether the catalogue field may contain null values."},"selected":{"type":"boolean","description":"Whether this dataset or field is selected for ingestion."},"classification":{"enum":["public","internal","confidential","restricted"],"type":"string","description":"Governance classification assigned to the discovered field."},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"description":"Human-readable explanation of the connector, field, or resource."}},"required":["id","datasetId","ordinal","providerName","logicalName","duckdbType","nullable","selected","classification","description"],"additionalProperties":false},"description":"Discovered or catalogue fields belonging to the dataset."},"latestRun":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"state":{"enum":["queued","extracting","committing","succeeded","failed","needs_auth","needs_review","canceled"],"type":"string","description":"Current lifecycle or execution state of the represented resource."},"startedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 start time, or null before execution begins."},"finishedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 completion time, or null while unfinished."}},"required":["id","state","startedAt","finishedAt"],"additionalProperties":false},{"type":"null"}],"description":"Latest ingestion run summary for the Source, or null."},"configurationRevision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0,"description":"Active monotonically increasing Source configuration revision."},"schemaRevisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"datasetId":{"type":"string","format":"uuid","description":"Dataset UUID within its Source and Account scope."},"revision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0,"description":"Positive connector, dataset, or schema revision number."},"schemaHash":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"SHA-256 digest of the normalized discovered schema."},"diffType":{"enum":["initial","additive","safe_widening","breaking","ambiguous"],"type":"string","description":"Classification of the discovered schema difference."},"state":{"enum":["discovered","accepted","rejected"],"type":"string","description":"Current lifecycle or execution state of the represented resource."},"model":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Discovered schema model retained for this schema revision."},"discoveredAt":{"type":"string","format":"date-time","description":"ISO 8601 time at which this schema revision was discovered."},"decidedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time at which the schema decision was recorded."},"decisionReason":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"description":"Reason retained with a schema revision decision."}},"required":["id","datasetId","revision","schemaHash","diffType","state","model","discoveredAt","decidedAt","decisionReason"],"additionalProperties":false},"description":"Discovered, accepted, and rejected schema revision history."},"schemaReviews":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"sourceId":{"type":"string","format":"uuid","description":"Source UUID within the Account scope."},"datasetId":{"type":"string","format":"uuid","description":"Dataset UUID within its Source and Account scope."},"datasetRevisionId":{"type":"string","format":"uuid","description":"Discovered dataset schema revision UUID awaiting a decision."},"diffType":{"enum":["breaking","ambiguous"],"type":"string","description":"Classification of the discovered schema difference."},"oldModel":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Previously accepted schema model compared by the review."},"newModel":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"New discovered schema model proposed by the review."},"state":{"enum":["open","accepted","rejected"],"type":"string","description":"Current lifecycle or execution state of the represented resource."},"decision":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"description":"Schema review decision or recorded decision explanation."},"createdAt":{"type":"string","format":"date-time","description":"ISO 8601 creation time of this resource or event."},"decidedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time at which the schema decision was recorded."}},"required":["id","sourceId","datasetId","datasetRevisionId","diffType","oldModel","newModel","state","decision","createdAt","decidedAt"],"additionalProperties":false},"description":"Breaking or ambiguous schema reviews for the Source."}},"required":["source","datasets","fields","latestRun","configurationRevision","schemaRevisions","schemaReviews"],"additionalProperties":false,"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}},"delete":{"operationId":"deleteSource","summary":"Delete Source","description":"Permanently delete a Source through the governed deletion workflow.","tags":["Sources"],"parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Source UUID within the Account scope.","example":"00000000-0000-4000-8000-000000000002"},{"in":"header","name":"Idempotency-Key","required":true,"description":"Unique key for this mutation and request body.","schema":{"type":"string","minLength":8,"maxLength":200},"example":"operation-20260816-001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"idempotencyKey":{"type":"string","minLength":8,"maxLength":200,"description":"Client-generated key reused only with the identical request body."},"confirmation":{"type":"string","minLength":1,"maxLength":300,"description":"Explicit Source deletion confirmation text shown by the product."}},"required":["accountId","confirmation"]},"example":{"accountId":"00000000-0000-4000-8000-000000000001","confirmation":"Acme Slack"}}}},"responses":{"202":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"deletionJobId":{"type":"string","format":"uuid","description":"Asynchronous Source deletion job UUID."},"state":{"const":"queued","description":"Current lifecycle or execution state of the represented resource."}},"required":["deletionJobId","state"],"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/sources/{sourceId}/configure":{"post":{"operationId":"configureSource","summary":"Configure Source","description":"Select a bounded set of discovered datasets and fields and set the Source ingestion schedule.","tags":["Sources"],"parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Source UUID within the Account scope.","example":"00000000-0000-4000-8000-000000000002"},{"in":"header","name":"Idempotency-Key","required":true,"description":"Unique key for this mutation and request body.","schema":{"type":"string","minLength":8,"maxLength":200},"example":"operation-20260816-001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"idempotencyKey":{"type":"string","minLength":8,"maxLength":200,"description":"Client-generated key reused only with the identical request body."},"schedule":{"enum":["manual","daily","hourly"],"type":"string","description":"Manual, daily, or hourly Source ingestion schedule."},"datasets":{"type":"array","minItems":1,"maxItems":500,"items":{"type":"object","properties":{"datasetId":{"type":"string","format":"uuid","description":"Dataset UUID within its Source and Account scope."},"providerNamespace":{"type":"string","maxLength":300},"providerName":{"type":"string","minLength":1,"maxLength":500,"description":"Original provider name of the dataset or field."},"selected":{"type":"boolean","description":"Whether this dataset or field is selected for ingestion."},"fields":{"type":"array","maxItems":2000,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":255,"description":"UUID or stable identifier of the represented resource."}},"required":["id"],"additionalProperties":false},"description":"Discovered or catalogue fields belonging to the dataset."}},"required":["datasetId","providerNamespace","providerName","selected","fields"],"additionalProperties":false},"description":"Datasets visible within the returned granted Source scope."}},"required":["accountId","schedule","datasets"]},"example":{"accountId":"00000000-0000-4000-8000-000000000001","schedule":"daily","datasets":[{"datasetId":"00000000-0000-4000-8000-000000000003","providerNamespace":"public","providerName":"messages","selected":true,"fields":[{"id":"id"},{"id":"text"}]}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"kind":{"enum":["desktop","saas"],"type":"string","description":"Principal or Source kind represented by this object."},"connectorKey":{"type":"string","description":"Stable key of the connector definition used by the Source."},"name":{"type":"string","minLength":1,"maxLength":300,"description":"Human-readable resource, principal, column, or type name."},"state":{"enum":["healthy","syncing","needs_authorization","needs_review","paused","failed","deleting","deleted"],"type":"string","description":"Current lifecycle or execution state of the represented resource."},"owner":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"UUID or stable identifier of the represented resource."},"name":{"type":"string","description":"Human-readable resource, principal, column, or type name."},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"description":"Principal or Source owner email address, when visible."}},"required":["id","name","email"],"additionalProperties":false},{"type":"null"}],"description":"Visible Source owner summary, or null when unassigned."},"datasetCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of datasets currently associated with the Source."},"endpointCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of Desktop endpoints associated with the Source."},"lastSuccessAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time of the latest successfully committed snapshot."},"issue":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":160,"description":"Stable machine-readable issue or error code."},"message":{"type":"string","minLength":1,"maxLength":1000,"description":"Human-readable issue or error explanation safe for the caller."},"action":{"anyOf":[{"type":"string","minLength":1,"maxLength":300},{"type":"null"}],"description":"Stable operational action name recorded by Activity."}},"required":["code","message","action"],"additionalProperties":false},{"type":"null"}],"description":"Current content-free issue and recommended action, or null."},"schedule":{"enum":["manual","daily","hourly"],"type":"string","description":"Manual, daily, or hourly Source ingestion schedule."},"stats":{"type":"array","maxItems":7,"items":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"UTC calendar date represented by the daily Source statistic."},"records":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records processed by an attempt or on a UTC date."},"errors":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of failed records or observations for this UTC date."},"bytes":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Uncompressed bytes processed by the attempt or daily Source statistic."}},"required":["date","records","errors","bytes"],"additionalProperties":false},"description":"Up to seven UTC daily record, error, and byte Source statistics."}},"required":["id","accountId","kind","connectorKey","name","state","owner","datasetCount","endpointCount","lastSuccessAt","issue","schedule","stats"],"additionalProperties":false,"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/sources/{sourceId}/run":{"post":{"operationId":"runSource","summary":"Run Source","description":"Queue an ingestion run for one Source.","tags":["Sources"],"parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Source UUID within the Account scope.","example":"00000000-0000-4000-8000-000000000002"},{"in":"header","name":"Idempotency-Key","required":true,"description":"Unique key for this mutation and request body.","schema":{"type":"string","minLength":8,"maxLength":200},"example":"operation-20260816-001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"idempotencyKey":{"type":"string","minLength":8,"maxLength":200,"description":"Client-generated key reused only with the identical request body."},"trigger":{"enum":["manual","first_sync","retry","recovery"],"type":"string","default":"manual","description":"Reason the ingestion run was queued."}},"required":["accountId"]},"example":{"accountId":"00000000-0000-4000-8000-000000000001","trigger":"manual"}}}},"responses":{"202":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"runId":{"type":"string","format":"uuid","description":"Ingestion run UUID associated with this operation or event."},"state":{"const":"queued","description":"Current lifecycle or execution state of the represented resource."}},"required":["runId","state"],"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/sources/{sourceId}/authorization-requests":{"post":{"operationId":"requestSourceAuthorization","summary":"Request Source Authorization","description":"Create a human authorization request for an existing Source.","tags":["Sources"],"parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Source UUID within the Account scope.","example":"00000000-0000-4000-8000-000000000002"},{"in":"header","name":"Idempotency-Key","required":true,"description":"Unique key for this mutation and request body.","schema":{"type":"string","minLength":8,"maxLength":200},"example":"operation-20260816-001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"idempotencyKey":{"type":"string","minLength":8,"maxLength":200,"description":"Client-generated key reused only with the identical request body."},"recipientEmail":{"type":"string","format":"email","description":"Email address of the intended Source authorizer."},"requestedScopes":{"type":"array","maxItems":100,"items":{"type":"string"},"description":"Provider authorization scopes requested for the existing Source."}},"required":["accountId","recipientEmail","requestedScopes"]},"example":{"accountId":"00000000-0000-4000-8000-000000000001","recipientEmail":"owner@example.com","requestedScopes":["channels:read","channels:history"]}}}},"responses":{"202":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","description":"Source authorization request UUID."},"sourceId":{"type":"string","format":"uuid","description":"Source UUID within the Account scope."},"authorizationUrl":{"type":"string","format":"uri","description":"Time-bounded URL the intended recipient opens to authorize the Source."},"delivery":{"enum":["sent","failed","not_configured"],"type":"string","description":"Authorization-request email delivery status."},"expiresAt":{"type":"string","format":"date-time","description":"Optional ISO 8601 expiry; null means no scheduled expiry."}},"required":["requestId","sourceId","authorizationUrl","delivery","expiresAt"],"additionalProperties":false,"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/sources/{sourceId}/pause":{"post":{"operationId":"pauseSource","summary":"Pause Source","description":"Pause scheduled ingestion for one Source.","tags":["Sources"],"parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Source UUID within the Account scope.","example":"00000000-0000-4000-8000-000000000002"},{"in":"header","name":"Idempotency-Key","required":true,"description":"Unique key for this mutation and request body.","schema":{"type":"string","minLength":8,"maxLength":200},"example":"operation-20260816-001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"idempotencyKey":{"type":"string","minLength":8,"maxLength":200,"description":"Client-generated key reused only with the identical request body."}},"required":["accountId"]},"example":{"accountId":"00000000-0000-4000-8000-000000000001"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"kind":{"enum":["desktop","saas"],"type":"string","description":"Principal or Source kind represented by this object."},"connectorKey":{"type":"string","description":"Stable key of the connector definition used by the Source."},"name":{"type":"string","minLength":1,"maxLength":300,"description":"Human-readable resource, principal, column, or type name."},"state":{"enum":["healthy","syncing","needs_authorization","needs_review","paused","failed","deleting","deleted"],"type":"string","description":"Current lifecycle or execution state of the represented resource."},"owner":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"UUID or stable identifier of the represented resource."},"name":{"type":"string","description":"Human-readable resource, principal, column, or type name."},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"description":"Principal or Source owner email address, when visible."}},"required":["id","name","email"],"additionalProperties":false},{"type":"null"}],"description":"Visible Source owner summary, or null when unassigned."},"datasetCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of datasets currently associated with the Source."},"endpointCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of Desktop endpoints associated with the Source."},"lastSuccessAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time of the latest successfully committed snapshot."},"issue":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":160,"description":"Stable machine-readable issue or error code."},"message":{"type":"string","minLength":1,"maxLength":1000,"description":"Human-readable issue or error explanation safe for the caller."},"action":{"anyOf":[{"type":"string","minLength":1,"maxLength":300},{"type":"null"}],"description":"Stable operational action name recorded by Activity."}},"required":["code","message","action"],"additionalProperties":false},{"type":"null"}],"description":"Current content-free issue and recommended action, or null."},"schedule":{"enum":["manual","daily","hourly"],"type":"string","description":"Manual, daily, or hourly Source ingestion schedule."},"stats":{"type":"array","maxItems":7,"items":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"UTC calendar date represented by the daily Source statistic."},"records":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records processed by an attempt or on a UTC date."},"errors":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of failed records or observations for this UTC date."},"bytes":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Uncompressed bytes processed by the attempt or daily Source statistic."}},"required":["date","records","errors","bytes"],"additionalProperties":false},"description":"Up to seven UTC daily record, error, and byte Source statistics."}},"required":["id","accountId","kind","connectorKey","name","state","owner","datasetCount","endpointCount","lastSuccessAt","issue","schedule","stats"],"additionalProperties":false,"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/sources/{sourceId}/resume":{"post":{"operationId":"resumeSource","summary":"Resume Source","description":"Resume scheduled ingestion for a paused Source.","tags":["Sources"],"parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Source UUID within the Account scope.","example":"00000000-0000-4000-8000-000000000002"},{"in":"header","name":"Idempotency-Key","required":true,"description":"Unique key for this mutation and request body.","schema":{"type":"string","minLength":8,"maxLength":200},"example":"operation-20260816-001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"idempotencyKey":{"type":"string","minLength":8,"maxLength":200,"description":"Client-generated key reused only with the identical request body."}},"required":["accountId"]},"example":{"accountId":"00000000-0000-4000-8000-000000000001"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"kind":{"enum":["desktop","saas"],"type":"string","description":"Principal or Source kind represented by this object."},"connectorKey":{"type":"string","description":"Stable key of the connector definition used by the Source."},"name":{"type":"string","minLength":1,"maxLength":300,"description":"Human-readable resource, principal, column, or type name."},"state":{"enum":["healthy","syncing","needs_authorization","needs_review","paused","failed","deleting","deleted"],"type":"string","description":"Current lifecycle or execution state of the represented resource."},"owner":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"UUID or stable identifier of the represented resource."},"name":{"type":"string","description":"Human-readable resource, principal, column, or type name."},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"description":"Principal or Source owner email address, when visible."}},"required":["id","name","email"],"additionalProperties":false},{"type":"null"}],"description":"Visible Source owner summary, or null when unassigned."},"datasetCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of datasets currently associated with the Source."},"endpointCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of Desktop endpoints associated with the Source."},"lastSuccessAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time of the latest successfully committed snapshot."},"issue":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":160,"description":"Stable machine-readable issue or error code."},"message":{"type":"string","minLength":1,"maxLength":1000,"description":"Human-readable issue or error explanation safe for the caller."},"action":{"anyOf":[{"type":"string","minLength":1,"maxLength":300},{"type":"null"}],"description":"Stable operational action name recorded by Activity."}},"required":["code","message","action"],"additionalProperties":false},{"type":"null"}],"description":"Current content-free issue and recommended action, or null."},"schedule":{"enum":["manual","daily","hourly"],"type":"string","description":"Manual, daily, or hourly Source ingestion schedule."},"stats":{"type":"array","maxItems":7,"items":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"UTC calendar date represented by the daily Source statistic."},"records":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records processed by an attempt or on a UTC date."},"errors":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of failed records or observations for this UTC date."},"bytes":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Uncompressed bytes processed by the attempt or daily Source statistic."}},"required":["date","records","errors","bytes"],"additionalProperties":false},"description":"Up to seven UTC daily record, error, and byte Source statistics."}},"required":["id","accountId","kind","connectorKey","name","state","owner","datasetCount","endpointCount","lastSuccessAt","issue","schedule","stats"],"additionalProperties":false,"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/schema-reviews/{reviewId}":{"post":{"operationId":"decideSchemaReview","summary":"Decide Schema Review","description":"Approve or reject a pending schema review before newly discovered fields become queryable.","tags":["Sources"],"parameters":[{"name":"reviewId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Schema review UUID.","example":"00000000-0000-4000-8000-000000000009"},{"in":"header","name":"Idempotency-Key","required":true,"description":"Unique key for this mutation and request body.","schema":{"type":"string","minLength":8,"maxLength":200},"example":"operation-20260816-001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"decision":{"enum":["accepted","rejected"],"type":"string","description":"Schema review decision or recorded decision explanation."},"reason":{"type":"string","maxLength":1000,"description":"Concise operator reason retained with the schema decision."},"idempotencyKey":{"type":"string","minLength":8,"maxLength":200,"description":"Client-generated key reused only with the identical request body."}},"required":["accountId","decision","reason"]},"example":{"accountId":"00000000-0000-4000-8000-000000000001","decision":"accepted","reason":"The additive fields are approved for governed querying."}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"reviewId":{"type":"string","format":"uuid","description":"Schema review UUID."},"decision":{"enum":["accepted","rejected"],"type":"string","description":"Schema review decision or recorded decision explanation."}},"required":["reviewId","decision"],"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/activity":{"get":{"operationId":"listActivity","summary":"List Activity","description":"List content-free operational activity visible to the authenticated principal.","tags":["Activity"],"parameters":[{"name":"accountId","in":"query","required":true,"schema":{"type":"string","format":"uuid"},"allowEmptyValue":true,"allowReserved":true,"description":"Account UUID that defines the tenant and authorization scope.","example":"00000000-0000-4000-8000-000000000001"},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":1024},"allowEmptyValue":true,"allowReserved":true,"description":"Opaque cursor returned by the preceding list response.","example":"eyJvZmZzZXQiOjUwfQ"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"allowEmptyValue":true,"allowReserved":true,"description":"Maximum number of items to return in this page.","example":50},{"name":"family","in":"query","required":false,"schema":{"type":"string"},"allowEmptyValue":true,"allowReserved":true,"description":"Optional operational activity family filter.","example":"query"},{"name":"sourceId","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"allowEmptyValue":true,"allowReserved":true,"description":"Source UUID within the Account scope.","example":"00000000-0000-4000-8000-000000000002"},{"name":"query","in":"query","required":false,"schema":{"type":"string","maxLength":300},"allowEmptyValue":true,"allowReserved":true,"description":"Optional case-insensitive text filter for this collection.","example":"Slack"},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"allowEmptyValue":true,"allowReserved":true,"description":"Inclusive ISO 8601 lower time bound.","example":"2026-08-01T00:00:00Z"},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"allowEmptyValue":true,"allowReserved":true,"description":"Exclusive ISO 8601 upper time bound.","example":"2026-08-16T00:00:00Z"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"family":{"enum":["run","delivery","authorization","endpoint","configuration","grant","query","deletion","support","backup","restore"],"type":"string","description":"Optional operational activity family filter."},"action":{"type":"string","minLength":1,"maxLength":160,"description":"Stable operational action name recorded by Activity."},"actor":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"UUID or stable identifier of the represented resource."},"name":{"type":"string","description":"Human-readable resource, principal, column, or type name."},"kind":{"anyOf":[{"enum":["human","agent","fde","service"],"type":"string"},{"type":"null"}],"description":"Principal or Source kind represented by this object."}},"required":["id","name","kind"],"description":"Content-free identity summary for the principal that caused the event."},"resource":{"type":"object","properties":{"type":{"type":"string","description":"Logical column type or content-free Activity resource type."},"id":{"type":"string","description":"UUID or stable identifier of the represented resource."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Human-readable resource, principal, column, or type name."}},"required":["type","id","name"],"description":"Content-free type, identifier, and name of the affected resource."},"outcome":{"enum":["succeeded","failed","denied","pending"],"type":"string","description":"Succeeded, failed, denied, or pending event outcome."},"summary":{"type":"string","minLength":1,"maxLength":1000,"description":"Content-free human-readable summary of the Activity event."},"sourceId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Source UUID within the Account scope."},"runId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Ingestion run UUID associated with this operation or event."},"correlationId":{"type":"string","description":"Request correlation ID to preserve in diagnostics and support reports."},"occurredAt":{"type":"string","format":"date-time","description":"ISO 8601 time at which the operational event occurred."},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"description":"Content-free scalar metadata associated with the Activity event."}},"required":["id","accountId","family","action","actor","resource","outcome","summary","sourceId","runId","correlationId","occurredAt","metadata"],"additionalProperties":false},"description":"Operation result payload authorized for the current principal."},"page":{"type":"object","properties":{"nextCursor":{"anyOf":[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}],"description":"Opaque cursor for the next page, or null when complete."},"hasMore":{"type":"boolean","description":"Whether another list page is available after this response."}},"required":["nextCursor","hasMore"],"additionalProperties":false,"description":"Cursor pagination metadata for this list response."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","page","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/activity/{eventId}":{"get":{"operationId":"getActivity","summary":"Get Activity","description":"Return one content-free operational activity event by identifier.","tags":["Activity"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Operational activity event UUID.","example":"00000000-0000-4000-8000-000000000007"},{"name":"accountId","in":"query","required":true,"schema":{"type":"string","format":"uuid"},"allowEmptyValue":true,"allowReserved":true,"description":"Account UUID that defines the tenant and authorization scope.","example":"00000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"event":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"family":{"enum":["run","delivery","authorization","endpoint","configuration","grant","query","deletion","support","backup","restore"],"type":"string","description":"Optional operational activity family filter."},"action":{"type":"string","minLength":1,"maxLength":160,"description":"Stable operational action name recorded by Activity."},"actor":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"UUID or stable identifier of the represented resource."},"name":{"type":"string","description":"Human-readable resource, principal, column, or type name."},"kind":{"anyOf":[{"enum":["human","agent","fde","service"],"type":"string"},{"type":"null"}],"description":"Principal or Source kind represented by this object."}},"required":["id","name","kind"],"description":"Content-free identity summary for the principal that caused the event."},"resource":{"type":"object","properties":{"type":{"type":"string","description":"Logical column type or content-free Activity resource type."},"id":{"type":"string","description":"UUID or stable identifier of the represented resource."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Human-readable resource, principal, column, or type name."}},"required":["type","id","name"],"description":"Content-free type, identifier, and name of the affected resource."},"outcome":{"enum":["succeeded","failed","denied","pending"],"type":"string","description":"Succeeded, failed, denied, or pending event outcome."},"summary":{"type":"string","minLength":1,"maxLength":1000,"description":"Content-free human-readable summary of the Activity event."},"sourceId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Source UUID within the Account scope."},"runId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Ingestion run UUID associated with this operation or event."},"correlationId":{"type":"string","description":"Request correlation ID to preserve in diagnostics and support reports."},"occurredAt":{"type":"string","format":"date-time","description":"ISO 8601 time at which the operational event occurred."},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"description":"Content-free scalar metadata associated with the Activity event."}},"required":["id","accountId","family","action","actor","resource","outcome","summary","sourceId","runId","correlationId","occurredAt","metadata"],"additionalProperties":false,"description":"Selected content-free Activity event."},"attempts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"attemptNumber":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0,"description":"One-based execution attempt number within a run."},"state":{"type":"string","description":"Current lifecycle or execution state of the represented resource."},"heartbeatAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Latest ISO 8601 worker heartbeat for this attempt."},"cpuSeconds":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"CPU seconds consumed by the ingestion attempt, when available."},"peakMemoryBytes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Peak memory bytes consumed by the attempt, when available."},"records":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records processed by an attempt or on a UTC date."},"bytes":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Uncompressed bytes processed by the attempt or daily Source statistic."},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Stable failure code recorded for an attempt or query receipt."},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Content-free failure message recorded for an attempt."},"startedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 start time, or null before execution begins."},"finishedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 completion time, or null while unfinished."}},"required":["id","attemptNumber","state","heartbeatAt","cpuSeconds","peakMemoryBytes","records","bytes","errorCode","errorMessage","startedAt","finishedAt"],"additionalProperties":false},"description":"Execution attempts associated with this activity event."},"deliveries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"sequence":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Zero-based delivery sequence number within its run."},"state":{"type":"string","description":"Current lifecycle or execution state of the represented resource."},"compressedBytes":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Compressed bytes stored for the delivery."},"recordCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of records contained in the ingestion delivery."},"schemaRevision":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0,"description":"Positive schema revision used by this delivery."},"snapshotId":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Committed snapshot sequence identifier, or null before commit."},"createdAt":{"type":"string","format":"date-time","description":"ISO 8601 creation time of this resource or event."},"committedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time at which the delivery became queryable."}},"required":["id","sequence","state","compressedBytes","recordCount","schemaRevision","snapshotId","createdAt","committedAt"],"additionalProperties":false},"description":"Committed or attempted ingestion deliveries linked to the event."},"receipt":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"principalId":{"type":"string","format":"uuid","description":"Human, agent, FDE, or service principal UUID."},"canonicalSqlHash":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"SHA-256 hash of canonical SQL retained without storing result content."},"sourceIds":{"type":"array","maxItems":8,"items":{"type":"string","format":"uuid"},"description":"Source UUIDs within the Account scope."},"datasetIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Dataset UUIDs within the granted Source scope."},"grantVersionStart":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0,"description":"Authorization version recorded when query execution began."},"grantVersionEnd":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0},{"type":"null"}],"description":"Authorization version checked before returning query results, when reached."},"state":{"enum":["queued","running","succeeded","denied","failed","timed_out","revoked","canceled"],"type":"string","description":"Current lifecycle or execution state of the represented resource."},"rows":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Typed result rows authorized and returned by the query."},"truncated":{"type":"boolean","description":"Whether an enforced row bound omitted additional result rows."},"estimatedBytes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Estimated bytes scanned by the recorded query, when known."},"durationMs":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Elapsed operation duration in milliseconds, when available."},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Stable failure code recorded for an attempt or query receipt."},"createdAt":{"type":"string","format":"date-time","description":"ISO 8601 creation time of this resource or event."},"finishedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 completion time, or null while unfinished."}},"required":["id","accountId","principalId","canonicalSqlHash","sourceIds","datasetIds","grantVersionStart","grantVersionEnd","state","rows","truncated","estimatedBytes","durationMs","errorCode","createdAt","finishedAt"],"additionalProperties":false},{"type":"null"}],"description":"Content-free query receipt linked to this event, or null."}},"required":["event","attempts","deliveries","receipt"],"additionalProperties":false,"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/grants":{"get":{"operationId":"listGrants","summary":"List Grants","description":"List grants visible in an account.","tags":["Access"],"parameters":[{"name":"accountId","in":"query","required":true,"schema":{"type":"string","format":"uuid"},"allowEmptyValue":true,"allowReserved":true,"description":"Account UUID that defines the tenant and authorization scope.","example":"00000000-0000-4000-8000-000000000001"},{"name":"principalId","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"allowEmptyValue":true,"allowReserved":true,"description":"Human, agent, FDE, or service principal UUID.","example":"00000000-0000-4000-8000-000000000004"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"kind":{"enum":["human","agent","fde","service"],"type":"string","description":"Principal or Source kind represented by this object."},"name":{"type":"string","minLength":1,"maxLength":300,"description":"Human-readable resource, principal, column, or type name."},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"description":"Principal or Source owner email address, when visible."},"authenticationStatus":{"enum":["active","pending","revoked","expired"],"type":"string","description":"Current authentication lifecycle state of the principal credential."},"grants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"principalId":{"type":"string","format":"uuid","description":"Human, agent, FDE, or service principal UUID."},"sourceId":{"type":"string","format":"uuid","description":"Source UUID within the Account scope."},"permission":{"enum":["query","manage"],"type":"string","description":"Capability granted for this Source scope."},"datasetIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Dataset UUIDs within the granted Source scope."},"expiresAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Optional ISO 8601 expiry; null means no scheduled expiry."},"maxRows":{"type":"integer","minimum":1,"maximum":10000,"description":"Hard maximum number of rows returned by the query."},"maxBytes":{"type":"integer","minimum":1,"maximum":268435456,"description":"Maximum input bytes the grant permits a query to scan."},"maxQueriesPerMinute":{"type":"integer","minimum":1,"maximum":60,"description":"Per-principal query rate bound for this grant."},"createdAt":{"type":"string","format":"date-time","description":"ISO 8601 creation time of this resource or event."},"revokedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 grant revocation time, or null while active."}},"required":["id","accountId","principalId","sourceId","permission","datasetIds","expiresAt","maxRows","maxBytes","maxQueriesPerMinute","createdAt","revokedAt"],"additionalProperties":false},"description":"Active and historical Source grants visible for this principal."},"lastUsedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time the principal last used Context OS, when known."},"recentQueryCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Recent query count attributed to this principal."},"issue":{"anyOf":[{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":160,"description":"Stable machine-readable issue or error code."},"message":{"type":"string","minLength":1,"maxLength":1000,"description":"Human-readable issue or error explanation safe for the caller."},"action":{"anyOf":[{"type":"string","minLength":1,"maxLength":300},{"type":"null"}],"description":"Stable operational action name recorded by Activity."}},"required":["code","message","action"],"additionalProperties":false},{"type":"null"}],"description":"Current content-free issue and recommended action, or null."}},"required":["id","kind","name","email","authenticationStatus","grants","lastUsedAt","recentQueryCount","issue"],"additionalProperties":false},"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}},"post":{"operationId":"createGrant","summary":"Create Grant","description":"Create a least-privilege grant for a principal. Reuse the same Idempotency-Key only with the identical request body.","tags":["Access"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"principalId":{"type":"string","format":"uuid","description":"Human, agent, FDE, or service principal UUID."},"sourceId":{"type":"string","format":"uuid","description":"Source UUID within the Account scope."},"permission":{"enum":["query","manage"],"type":"string","description":"Capability granted for this Source scope."},"datasetIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Dataset UUIDs within the granted Source scope."},"expiresAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Optional ISO 8601 expiry; null means no scheduled expiry."},"maxRows":{"type":"integer","minimum":1,"maximum":10000,"description":"Hard maximum number of rows returned by the query."},"maxBytes":{"type":"integer","minimum":1,"maximum":268435456,"description":"Maximum input bytes the grant permits a query to scan."},"maxQueriesPerMinute":{"type":"integer","minimum":1,"maximum":60,"description":"Per-principal query rate bound for this grant."},"idempotencyKey":{"type":"string","minLength":8,"maxLength":200,"description":"Client-generated key reused only with the identical request body."}},"required":["accountId","principalId","sourceId","permission","datasetIds","expiresAt","maxRows","maxBytes","maxQueriesPerMinute"],"additionalProperties":false},"example":{"accountId":"00000000-0000-4000-8000-000000000001","principalId":"00000000-0000-4000-8000-000000000004","sourceId":"00000000-0000-4000-8000-000000000002","permission":"query","datasetIds":["00000000-0000-4000-8000-000000000003"],"expiresAt":null,"maxRows":1000,"maxBytes":268435456,"maxQueriesPerMinute":60}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"principalId":{"type":"string","format":"uuid","description":"Human, agent, FDE, or service principal UUID."},"sourceId":{"type":"string","format":"uuid","description":"Source UUID within the Account scope."},"permission":{"enum":["query","manage"],"type":"string","description":"Capability granted for this Source scope."},"datasetIds":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Dataset UUIDs within the granted Source scope."},"expiresAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Optional ISO 8601 expiry; null means no scheduled expiry."},"maxRows":{"type":"integer","minimum":1,"maximum":10000,"description":"Hard maximum number of rows returned by the query."},"maxBytes":{"type":"integer","minimum":1,"maximum":268435456,"description":"Maximum input bytes the grant permits a query to scan."},"maxQueriesPerMinute":{"type":"integer","minimum":1,"maximum":60,"description":"Per-principal query rate bound for this grant."},"createdAt":{"type":"string","format":"date-time","description":"ISO 8601 creation time of this resource or event."},"revokedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 grant revocation time, or null while active."}},"required":["id","accountId","principalId","sourceId","permission","datasetIds","expiresAt","maxRows","maxBytes","maxQueriesPerMinute","createdAt","revokedAt"],"additionalProperties":false,"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"description":"Unique key for this mutation and request body.","schema":{"type":"string","minLength":8,"maxLength":200},"example":"operation-20260816-001"}]}},"/v1/grants/{grantId}":{"delete":{"operationId":"revokeGrant","summary":"Revoke Grant","description":"Revoke a grant so future access checks deny that capability.","tags":["Access"],"parameters":[{"name":"grantId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Grant UUID.","example":"00000000-0000-4000-8000-000000000005"},{"in":"header","name":"Idempotency-Key","required":true,"description":"Unique key for this mutation and request body.","schema":{"type":"string","minLength":8,"maxLength":200},"example":"operation-20260816-001"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"idempotencyKey":{"type":"string","minLength":8,"maxLength":200,"description":"Client-generated key reused only with the identical request body."}},"required":["accountId"]},"example":{"accountId":"00000000-0000-4000-8000-000000000001"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"grantId":{"type":"string","format":"uuid","description":"Grant UUID."},"revoked":{"const":true,"description":"True when the grant revocation completed successfully."},"grantVersion":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0,"description":"Account authorization version evaluated for this operation or revocation."}},"required":["grantId","revoked","grantVersion"],"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/onboarding/status":{"get":{"operationId":"getOnboardingStatus","summary":"Get Onboarding Status","description":"Return this AI's verified setup state and the exact next action it should take.","tags":["Onboarding"],"parameters":[{"name":"accountId","in":"query","required":true,"schema":{"type":"string","format":"uuid"},"allowEmptyValue":true,"allowReserved":true,"description":"Account UUID that defines the tenant and authorization scope.","example":"00000000-0000-4000-8000-000000000001"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"agent":{"type":"object","properties":{"principalId":{"type":"string","format":"uuid","description":"Human, agent, FDE, or service principal UUID."},"workosRegistrationId":{"type":"string"},"capabilities":{"type":"array","items":{"enum":["query","manage"],"type":"string"},"description":"Connector operations supported by this definition revision."}},"required":["principalId","workosRegistrationId","capabilities"]},"completed":{"type":"boolean"},"completionReceiptId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"humanActionUrl":{"type":"string","format":"uri"},"latestEligibleReceiptId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"nextAction":{"enum":["connect_source","wait_for_source","configure_source","sync_source","wait_for_sync","grant_source","query_source","complete_onboarding","complete"],"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"availableDatasetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"datasetCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of datasets currently associated with the Source."},"displayName":{"type":"string"},"granted":{"type":"boolean"},"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"lastSuccessAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time of the latest successfully committed snapshot."},"state":{"type":"string","description":"Current lifecycle or execution state of the represented resource."}},"required":["availableDatasetCount","datasetCount","displayName","granted","id","lastSuccessAt","state"]}}},"required":["accountId","agent","completed","completionReceiptId","humanActionUrl","latestEligibleReceiptId","nextAction","sources"],"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/onboarding/grant":{"post":{"operationId":"grantOnboardingSource","summary":"Grant Onboarding Source","description":"Grant this AI query access to one synced Source and its selected datasets during setup.","tags":["Onboarding"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"sourceId":{"type":"string","format":"uuid","description":"Source UUID within the Account scope."}},"required":["accountId","sourceId"]},"example":{"accountId":"00000000-0000-4000-8000-000000000001","sourceId":"00000000-0000-4000-8000-000000000002"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"agent":{"type":"object","properties":{"principalId":{"type":"string","format":"uuid","description":"Human, agent, FDE, or service principal UUID."},"workosRegistrationId":{"type":"string"},"capabilities":{"type":"array","items":{"enum":["query","manage"],"type":"string"},"description":"Connector operations supported by this definition revision."}},"required":["principalId","workosRegistrationId","capabilities"]},"completed":{"type":"boolean"},"completionReceiptId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"humanActionUrl":{"type":"string","format":"uri"},"latestEligibleReceiptId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"nextAction":{"enum":["connect_source","wait_for_source","configure_source","sync_source","wait_for_sync","grant_source","query_source","complete_onboarding","complete"],"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"availableDatasetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"datasetCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of datasets currently associated with the Source."},"displayName":{"type":"string"},"granted":{"type":"boolean"},"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"lastSuccessAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time of the latest successfully committed snapshot."},"state":{"type":"string","description":"Current lifecycle or execution state of the represented resource."}},"required":["availableDatasetCount","datasetCount","displayName","granted","id","lastSuccessAt","state"]}}},"required":["accountId","agent","completed","completionReceiptId","humanActionUrl","latestEligibleReceiptId","nextAction","sources"],"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}},"/v1/onboarding/complete":{"post":{"operationId":"completeOnboarding","summary":"Complete Onboarding","description":"Complete setup only after the server verifies a successful query receipt created by this same AI against its active grant.","tags":["Onboarding"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"receiptId":{"type":"string","format":"uuid","description":"Query receipt UUID used for content-free audit status."}},"required":["accountId"]},"example":{"accountId":"00000000-0000-4000-8000-000000000001","receiptId":"00000000-0000-4000-8000-000000000006"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"accountId":{"type":"string","format":"uuid","description":"Account UUID that defines the tenant and authorization scope."},"agent":{"type":"object","properties":{"principalId":{"type":"string","format":"uuid","description":"Human, agent, FDE, or service principal UUID."},"workosRegistrationId":{"type":"string"},"capabilities":{"type":"array","items":{"enum":["query","manage"],"type":"string"},"description":"Connector operations supported by this definition revision."}},"required":["principalId","workosRegistrationId","capabilities"]},"completed":{"type":"boolean"},"completionReceiptId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"humanActionUrl":{"type":"string","format":"uri"},"latestEligibleReceiptId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"nextAction":{"enum":["connect_source","wait_for_source","configure_source","sync_source","wait_for_sync","grant_source","query_source","complete_onboarding","complete"],"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"availableDatasetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"datasetCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Number of datasets currently associated with the Source."},"displayName":{"type":"string"},"granted":{"type":"boolean"},"id":{"type":"string","format":"uuid","description":"UUID or stable identifier of the represented resource."},"lastSuccessAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 time of the latest successfully committed snapshot."},"state":{"type":"string","description":"Current lifecycle or execution state of the represented resource."}},"required":["availableDatasetCount","datasetCount","displayName","granted","id","lastSuccessAt","state"]}},"evidence":{"type":"object","properties":{"completed_at":{"type":"string","format":"date-time"},"receipt_id":{"type":"string","format":"uuid"},"source_id":{"type":"string","format":"uuid"}},"required":["completed_at","receipt_id","source_id"]}},"required":["accountId","agent","completed","completionReceiptId","humanActionUrl","latestEligibleReceiptId","nextAction","sources","evidence"],"description":"Operation result payload authorized for the current principal."},"correlationId":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","description":"Request correlation ID to preserve in diagnostics and support reports."}},"required":["data","correlationId"],"additionalProperties":false}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"400":{"description":"Malformed request or invalid JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Malformed request or invalid JSON.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"401":{"description":"Missing, invalid, expired, or revoked credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"unauthenticated","message":"Missing, invalid, expired, or revoked credential.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"WWW-Authenticate":{"description":"Bearer authentication challenge. MCP exposes separate protected-resource discovery metadata.","schema":{"type":"string"}}}},"403":{"description":"The principal lacks the required account capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"forbidden","message":"The principal lacks the required account capability.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"404":{"description":"The requested visible resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"not_found","message":"The requested visible resource does not exist.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"409":{"description":"Request conflicts with current state or idempotency history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"conflict","message":"Request conflicts with current state or idempotency history.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"413":{"description":"Request payload exceeds the accepted bound.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"payload_too_large","message":"Request payload exceeds the accepted bound.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"422":{"description":"Request is well-formed but fails validation or query policy.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"bad_request","message":"Request is well-formed but fails validation or query policy.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"429":{"description":"Rate or resource limit exceeded. Respect Retry-After when present.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"rate_limited","message":"Rate or resource limit exceeded. Respect Retry-After when present.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected server failure. Preserve the correlation ID for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"internal_error","message":"Unexpected server failure. Preserve the correlation ID for support.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}}}},"503":{"description":"A required dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"},"example":{"error":{"code":"temporarily_unavailable","message":"A required dependency is temporarily unavailable.","correlationId":"cor_01K2A000000000000000000101"}}}},"headers":{"Cache-Control":{"description":"Authenticated API responses are never cacheable.","schema":{"type":"string","example":"no-store"}},"X-Correlation-ID":{"description":"Request correlation ID, identical to the envelope value.","schema":{"type":"string","pattern":"^cor_[0-9A-HJKMNP-TV-Z]{26}$","example":"cor_01K2A000000000000000000101"}},"Retry-After":{"description":"Seconds to wait before a bounded retry.","schema":{"type":"integer","minimum":1}}}}}}}},"tags":[{"name":"Accounts","description":"Discover Accounts visible to the authenticated human, agent, or service principal."},{"name":"Catalogue","description":"Discover granted Sources, logical SQL relations, fields, classifications, and freshness."},{"name":"Query","description":"Execute bounded read-only SQL and retrieve content-free audit receipts."},{"name":"Sources","description":"Inspect and operate Sources, authorization requests, connector definitions, and schema reviews."},{"name":"Activity","description":"List content-free operational events and inspect their attempts, deliveries, and receipts."},{"name":"Access","description":"List, create, and revoke least-privilege Source and dataset grants."},{"name":"Onboarding","description":"Drive AI-first Account setup to a server-verified first governed query."}]}