{"openapi":"3.1.2","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"pagesend first-party HTTP API","version":"1","description":"Generated from repository runtime Zod DTOs and the named HTTP adapter catalog. Canonical artifact URLs are /@{workspace}/{slug}/{path}; /api/v1 is an API contract version, never a publication revision. The server enforces all current authorization, state, custom refinement, quota, and origin checks; JSON Schema is descriptive, not an authorization mechanism. Better Auth owns its authentication/OAuth protocol routes and discovery outside this first-party catalog."},"servers":[{"url":"/","description":"The configured canonical app origin; customer content is served from a separate registrable domain."}],"tags":[{"name":"Account and workspaces"},{"name":"Artifacts"},{"name":"Runtime data"},{"name":"Operations"},{"name":"OAuth browser commands"}],"paths":{"/api/v1/auth/providers":{"get":{"operationId":"getSignInProviders","summary":"Available sign-in methods","tags":["Account and workspaces"],"description":"Public non-cached configuration flags. Never returns credentials or user identifiers.","security":[],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignInProviders"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/environment":{"get":{"operationId":"getEnvironment","summary":"Read bounded environment metadata","tags":["Account and workspaces"],"security":[],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Environment"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/openapi":{"get":{"operationId":"getOpenApi","summary":"Read this generated API description","tags":["Account and workspaces"],"security":[],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","description":"This OpenAPI 3.1.2 document."}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/terms":{"get":{"operationId":"getLaunchTermsStatus","summary":"Read the current Terms acceptance state","tags":["Account and workspaces"],"security":[{"WebSession":[]}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LaunchTermsStatus"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/terms/accept":{"post":{"operationId":"acceptLaunchTerms","summary":"Accept the current Terms of Service","tags":["Account and workspaces"],"description":"Verified first-party session. Repeat acceptance returns the original receipt. A stale version returns 409.","security":[{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LaunchTermsAcceptance"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LaunchTermsStatus"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/me":{"get":{"operationId":"getAccount","summary":"Read the current account","tags":["Account and workspaces"],"security":[{"WebSession":[]}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountProfile"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"patch":{"operationId":"updateAccount","summary":"Update your profile and default workspace","tags":["Account and workspaces"],"description":"First-party web session only. If-Match is the quoted profileVersion; stale edits return412. Changing workspaces does not update this preference. Name/default/photo edits share one atomic profile version.","security":[{"WebSession":[]}],"parameters":[{"$ref":"#/components/parameters/IfMatch"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountProfile"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountProfile"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/me/avatar":{"get":{"operationId":"getAccountAvatar","summary":"Read your private account photo","tags":["Account and workspaces"],"description":"Authenticated self-only no-store JPEG/PNG response. Provider URLs never reach the browser; unsupported/unavailable photos return an error and the UI uses initials.","security":[{"WebSession":[]}],"parameters":[{"name":"v","in":"query","required":false,"schema":{"type":"string","maxLength":128},"description":"Display cache-busting version; never selects another user's photo."}],"responses":{"200":{"description":"Success.","content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"put":{"operationId":"updateAccountAvatar","summary":"Replace your private account photo","tags":["Account and workspaces"],"description":"Raw JPEG/PNG, streamed limit128KiB and at most1024px per dimension. If-Match is the current quoted profileVersion; removal/reset uses PATCH/me. No arbitrary image URL or another user ID is accepted.","security":[{"WebSession":[]}],"parameters":[{"$ref":"#/components/parameters/IfMatch"}],"requestBody":{"required":true,"content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}}}},"x-max-request-bytes":131072,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountProfile"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/workspaces":{"get":{"operationId":"listWorkspaces","summary":"List current workspace memberships","tags":["Account and workspaces"],"security":[{"WebSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":512},"description":"Opaque, scoped continuation cursor. Reuse without editing."}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Workspace"},"maxItems":50},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"operationId":"createWorkspace","summary":"Create a workspace","tags":["Account and workspaces"],"security":[{"WebSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceInput"}}}},"x-max-request-bytes":16384,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Workspace"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/workspaces/{workspaceId}/overview":{"get":{"operationId":"getWorkspaceOverview","summary":"Read current-readable page counts, recent metadata, own connections and authorized usage","tags":["Account and workspaces"],"security":[{"WebSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceOverview"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/workspaces/{workspaceId}/members":{"get":{"operationId":"listMembers","summary":"List workspace members","tags":["Account and workspaces"],"description":"Current verified web co-members only. Names, emails and private first-party photo URLs; no provider URLs or thumbnail bytes.","security":[{"WebSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":512},"description":"Opaque, scoped continuation cursor. Reuse without editing."}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceMemberPage"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/workspaces/{workspaceId}/members/{userId}/avatar":{"get":{"operationId":"getMemberAvatar","summary":"Read a current workspace member photo","tags":["Account and workspaces"],"description":"Current web session and both current workspace memberships required, including after remote fetching. Private no-store JPEG/PNG with the existing provider/byte limits. Display keys convey no authorization.","security":[{"WebSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","maxLength":128,"minLength":1}},{"name":"v","in":"query","required":false,"schema":{"type":"string","maxLength":32}},{"name":"account","in":"query","required":false,"schema":{"type":"string","maxLength":32}}],"responses":{"200":{"description":"Success.","content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/workspaces/{workspaceId}/members/{userId}":{"delete":{"operationId":"removeMember","summary":"Remove a workspace member","tags":["Account and workspaces"],"description":"Owner/admin rules apply; the final owner cannot be removed. This legacy command does not require an idempotency header.","security":[{"WebSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","maxLength":128,"minLength":1}}],"responses":{"204":{"description":"Completed with no response body."},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/workspaces/{workspaceId}/invitations":{"get":{"operationId":"listInvitations","summary":"List invitations as a workspace manager","tags":["Account and workspaces"],"security":[{"WebSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":512},"description":"Opaque, scoped continuation cursor. Reuse without editing."}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/InvitationStatus"},"maxItems":50},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"operationId":"inviteMember","summary":"Invite a member by verified email delivery","tags":["Account and workspaces"],"description":"The one-use invitation capability is delivered by email and never returned in this response.","security":[{"WebSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationInput"}}}},"x-max-request-bytes":16384,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Invitation"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/workspaces/{workspaceId}/invitations/{invitationId}":{"delete":{"operationId":"revokeInvitation","summary":"Revoke an invitation","tags":["Account and workspaces"],"security":[{"WebSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"invitationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"204":{"description":"Completed with no response body."},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/invitations/continuations":{"post":{"operationId":"beginInvitationContinuation","summary":"Preserve an invitation across browser sign-in","tags":["Account and workspaces"],"description":"Same-origin, bounded and rate-limited browser handoff. Sets a per-flow HttpOnly SameSite=Lax nonce cookie (Secure on HTTPS).15-minute expiry. Does not reveal recipient/workspace metadata or accept the invitation.","security":[{},{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationContinuationInput"}}}},"x-max-request-bytes":256,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationContinuation"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/invitations/continuations/{continuationId}":{"get":{"operationId":"getInvitationContinuation","summary":"Validate a pending browser-bound invitation","tags":["Account and workspaces"],"description":"Requires the matching per-flow browser nonce cookie. Returns expiry only, never recipient/workspace details; no membership is granted.","security":[{},{"WebSession":[]}],"parameters":[{"name":"continuationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationContinuationStatus"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/invitations/accept":{"post":{"operationId":"acceptInvitation","summary":"Accept an invitation for the signed-in email","tags":["Account and workspaces"],"description":"Explicit acceptance for the current verified invited web account. Accepts exactly a raw token or browser-bound continuation ID. Both share atomic session/email/expiry/revocation and single-use checks; success selects the joined workspace for this session.","security":[{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptInvitationInput"}}}},"x-max-request-bytes":256,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationAcceptance"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/sessions":{"get":{"operationId":"listSessions","summary":"List active account sessions with a stable account-scoped cursor","tags":["Account and workspaces"],"security":[{"WebSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":512},"description":"Opaque, scoped continuation cursor. Reuse without editing."}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionPage"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/page-invitations/continuations":{"post":{"operationId":"beginPageInvitationContinuation","summary":"Preserve a page invitation across browser sign-in","tags":["Account and workspaces"],"description":"Browser-bound 15-minute HttpOnly continuation. Returns no page or recipient metadata and creates no membership. Email codes are sent only in the bounded POST body.","security":[{},{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationContinuationInput"}}}},"x-max-request-bytes":256,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationContinuation"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/page-invitations/continuations/{continuationId}":{"get":{"operationId":"getPageInvitationContinuation","summary":"Validate a browser-bound page invitation","tags":["Account and workspaces"],"description":"Requires the page-invitation-specific browser cookie and returns expiry only. Workspace invitation continuations cannot be substituted.","security":[{},{"WebSession":[]}],"parameters":[{"name":"continuationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationContinuationStatus"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/page-invitations/accept":{"post":{"operationId":"acceptPageInvitation","summary":"Accept access to one page with the matching verified email","tags":["Account and workspaces"],"description":"Atomically consumes the browser-bound invitation and grants artifact:read only. Does not create membership or change the selected workspace. Runtime access remains subject to collection policy.","security":[{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptPageInvitationInput"}}}},"x-max-request-bytes":256,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptedPageInvitation"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/sessions/{sessionId}":{"delete":{"operationId":"revokeSession","summary":"Revoke an account session and bound renders","tags":["Account and workspaces"],"security":[{"WebSession":[]}],"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"204":{"description":"Completed with no response body."},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/connections":{"get":{"operationId":"listConnections","summary":"List this account's MCP connection metadata","tags":["Account and workspaces"],"security":[{"WebSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":36},"description":"Opaque, scoped continuation cursor. Reuse without editing."},{"name":"workspaceId","in":"query","required":false,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionPage"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/connections/{connectionId}":{"delete":{"operationId":"revokeConnection","summary":"Revoke a connected MCP client grant","tags":["Account and workspaces"],"security":[{"WebSession":[]}],"parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionRevocation"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/me/deletion":{"get":{"operationId":"getAccountClosure","summary":"Review a scope deletion plan or existing workspace receipt","tags":["Account and workspaces"],"description":"Fresh signed-in account session required. A closed workspace receipt is visible only to its closing owner. No private content is returned.","security":[{"WebSession":[]}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScopeClosurePlan"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"operationId":"requestAccountClosure","summary":"Confirm scope deletion with a current plan","tags":["Account and workspaces"],"description":"Fresh session, current ownership/scope version, exact typed label, digest, and explicit confirmation are required. Logical denial is immediate; configured retention and background cleanup govern physical deletion.","security":[{"WebSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScopeClosureRequest"}}}},"x-max-request-bytes":16384,"responses":{"202":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScopeClosureReceipt"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/workspaces/{workspaceId}/deletion":{"get":{"operationId":"getWorkspaceClosure","summary":"Review a scope deletion plan or existing workspace receipt","tags":["Account and workspaces"],"description":"Fresh signed-in account session required. A closed workspace receipt is visible only to its closing owner. No private content is returned.","security":[{"WebSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ScopeClosurePlan"},{"$ref":"#/components/schemas/ScopeClosureReceipt"}]}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"operationId":"requestWorkspaceClosure","summary":"Confirm scope deletion with a current plan","tags":["Account and workspaces"],"description":"Fresh session, current ownership/scope version, exact typed label, digest, and explicit confirmation are required. Logical denial is immediate; configured retention and background cleanup govern physical deletion.","security":[{"WebSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScopeClosureRequest"}}}},"x-max-request-bytes":16384,"responses":{"202":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScopeClosureReceipt"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/viewer/bootstrap":{"post":{"operationId":"bootstrapViewer","summary":"Resolve a page and create a consistent revision-pinned viewer","tags":["Artifacts"],"description":"One authorized publication snapshot supplies page metadata, canonical head, render session and initial route. Requires the normal mutation-origin checks; shares the per-page render creation rate limit. A changed publication or policy returns 412. Missing local routes return exists=false. Responses are no-store; Server-Timing contains numeric lookup, authorize and session durations only.","security":[{},{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ViewerBootstrapRequest"}}}},"x-max-request-bytes":16384,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ViewerBootstrap"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/resolve/{workspace}/{slug}":{"get":{"operationId":"resolveArtifact","summary":"Resolve an address to its stable artifact","tags":["Artifacts"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"workspace","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Slug"}},{"name":"slug","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Slug"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Artifact"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts":{"get":{"operationId":"listArtifacts","summary":"List authorized workspace artifacts","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"workspaceId","in":"query","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":2048},"description":"Opaque, scoped continuation cursor. Reuse without editing."},{"name":"search","in":"query","required":false,"schema":{"type":"string","maxLength":120,"default":""}},{"name":"visibility","in":"query","required":false,"schema":{"$ref":"#/components/schemas/Visibility"}},{"name":"includeCapabilities","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"default":"false","description":"Include bounded per-artifact permission hints for immediate action menus. Action requests still authorize independently."}},{"name":"includeOwners","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"default":"false"}},{"name":"deleted","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"default":"false"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactListPage"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"operationId":"createArtifact","summary":"Create a private artifact with a stable ID","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateArtifact"}}}},"x-max-request-bytes":16384,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactCreated"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/seo":{"get":{"operationId":"getArtifactSeo","summary":"Read authorized search settings and immutable route metadata","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactSeoSnapshot"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"patch":{"operationId":"updateArtifactSeo","summary":"Save search metadata; explicit search eligibility changes also require audience permission","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeoUpdateBody"}}}},"x-max-request-bytes":262144,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactSeoSnapshot"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/management":{"get":{"operationId":"getArtifactManagement","summary":"Read authorized artifact metadata, publication and capabilities together","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactManagement"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}":{"get":{"operationId":"getArtifact","summary":"Read currently authorized artifact metadata","tags":["Artifacts"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Artifact"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"patch":{"operationId":"updateArtifact","summary":"Change title or slug with an update precondition","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactUpdate"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Artifact"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"delete":{"operationId":"deleteArtifact","summary":"Logically delete and immediately deny new access","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedUpdatedAt"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactDeletion"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/restore":{"post":{"operationId":"restoreArtifact","summary":"Restore within the configured retention boundary","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpectedUpdatedAt"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Artifact"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/permissions":{"get":{"operationId":"getArtifactPermissions","summary":"Read advisory current artifact capabilities","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/Capability"},"maxItems":7}},"required":["capabilities"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/access":{"patch":{"operationId":"changeArtifactAccess","summary":"Change visibility with explicit public confirmation","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccessInput"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyReceipt"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/grants":{"get":{"operationId":"listArtifactGrants","summary":"List explicit grants as an artifact manager","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":512},"description":"Opaque, scoped continuation cursor. Reuse without editing."}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ArtifactGrant"},"maxItems":50},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"put":{"operationId":"setArtifactGrant","summary":"Set an allowlisted explicit grant","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantInput"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyReceipt"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/invitations":{"get":{"operationId":"listPageInvitations","summary":"List pending invitations as the page owner","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":512},"description":"Opaque, scoped continuation cursor. Reuse without editing."}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageInvitationPage"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"operationId":"invitePageReader","summary":"Invite a person to access this page without joining its workspace","tags":["Artifacts"],"description":"Owner-only verified email delivery; pending and active recipients share a 100-person limit. Seven-day invitations. Reinviting replaces the pending code; retries reuse the same idempotency key. Sent is returned only after provider acknowledgement.","security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageInvitationInput"}}}},"x-max-request-bytes":1024,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageInvitationResult"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/invitations/{invitationId}":{"delete":{"operationId":"cancelPageInvitation","summary":"Cancel a page invitation as its owner","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"invitationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelPageInvitationInput"}}}},"x-max-request-bytes":256,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyReceipt"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/grants/{userId}":{"delete":{"operationId":"revokeArtifactGrant","summary":"Revoke an explicit grant","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","maxLength":128,"minLength":1}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantRevokeInput"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyReceipt"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/uploads":{"post":{"operationId":"prepareUpload","summary":"Reserve bounded private upload staging","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HttpPrepareUpload"}}}},"x-max-request-bytes":131072,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreparedUpload"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/uploads/{uploadId}":{"get":{"operationId":"getUpload","summary":"Read the upload state machine","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"uploadId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadSession"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/uploads/{uploadId}/content":{"put":{"operationId":"transferUpload","summary":"Stream bytes into a private staging reservation","tags":["Artifacts"],"description":"Only the short-lived transfer capability for this upload is accepted. This path bypasses cookie identity intentionally; optional Origin must still equal the app and cross-site fetches are denied. Streaming byte limits and the declared hash are checked. The capability is not a canonical share URL.","security":[{"UploadCapability":[]}],"parameters":[{"name":"uploadId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"x-max-request-bytes":16777216,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadSession"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/uploads/{uploadId}/finalize":{"post":{"operationId":"finalizeUpload","summary":"Validate and seal an immutable file revision","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"uploadId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinalizeResult"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/uploads/{uploadId}/cancel":{"post":{"operationId":"cancelUpload","summary":"Cancel staging and release its reservation","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"uploadId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadSession"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/revisions":{"get":{"operationId":"listRevisions","summary":"Read authorized bounded revision history","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":512},"description":"Opaque, scoped continuation cursor. Reuse without editing."}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/RevisionSummary"},"maxItems":50},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/publications":{"post":{"operationId":"publishArtifact","summary":"Atomically publish a ready immutable revision","tags":["Artifacts"],"description":"Use If-Match: \"none\" for the first publication, or the quoted current publication token. New visits read the authoritative active pointer; canonical paths never contain revision IDs.","security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HttpPublishInput"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishResult"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/head":{"get":{"operationId":"getPublicationHead","summary":"Read the authoritative current publication","tags":["Artifacts"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicationHead"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/render-sessions":{"post":{"operationId":"createRenderSession","summary":"Create a revision-pinned isolated content session","tags":["Artifacts"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"x-max-request-bytes":16384,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenderSession"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/preview-sessions":{"post":{"operationId":"createPreviewSession","summary":"Preview a ready revision under current publishing permission","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewInput"}}}},"x-max-request-bytes":16384,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewSession"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/render-sessions/{renderSessionId}":{"delete":{"operationId":"revokeRenderSession","summary":"Revoke the caller-bound render session","tags":["Artifacts"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"renderSessionId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"204":{"description":"Completed with no response body."},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/render-sessions/{renderSessionId}/renew":{"post":{"operationId":"renewRenderSession","summary":"Renew a caller-bound pinned render session","tags":["Artifacts"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"renderSessionId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/Id"},"expiresAt":{"type":"integer","minimum":0}},"required":["id","expiresAt"],"additionalProperties":false,"x-adapter-source":"packages/domain/rendering/index.ts#renewSession"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/render-sessions/{renderSessionId}/access":{"get":{"operationId":"getRenderAccess","summary":"Validate access to the existing pinned render without resolving publication","tags":["Artifacts"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"renderSessionId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenderAccess"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/render-sessions/{renderSessionId}/operations":{"post":{"operationId":"performRenderOperation","summary":"Run an allowlisted operation for the bound render","tags":["Artifacts"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"renderSessionId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"$ref":"#/components/schemas/MutationKey"},"description":"Required for data.create, data.update, data.delete, and data.submit; other operations do not require this header."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeOperation"}}}},"x-max-request-bytes":32768,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeOperationResult"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/exports":{"get":{"operationId":"listArtifactExports","summary":"List the caller's authorized private exports","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":512},"description":"Opaque, scoped continuation cursor. Reuse without editing."}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ArtifactExport"},"maxItems":50},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"operationId":"createArtifactExport","summary":"Create a private bounded export","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactExportRequest"}}}},"x-max-request-bytes":16384,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactExport"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/exports/status":{"post":{"operationId":"getArtifactExportStatuses","summary":"Read up to 25 caller-owned export statuses with one authorization","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportStatusInput"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportStatusResult"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/exports/{exportId}":{"get":{"operationId":"getArtifactExport","summary":"Read current export status","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"exportId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactExport"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/exports/{exportId}/download":{"get":{"operationId":"downloadArtifactExport","summary":"Download as the requesting actor with current authorization","tags":["Artifacts"],"description":"Private zip, not a public bucket or transferable query capability. Expiry and current artifact access are rechecked.","security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"exportId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/zip":{"schema":{"type":"string","format":"binary","x-max-bytes":35651584}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/duplicates":{"post":{"operationId":"duplicateArtifact","summary":"Copy an authorized revision to a new private artifact","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicateArtifact"}}}},"x-max-request-bytes":16384,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactDuplicate"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/duplicates/{duplicateId}":{"get":{"operationId":"getArtifactDuplicate","summary":"Read current duplication status","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"duplicateId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactDuplicate"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/revisions/{revisionId}/retirement":{"get":{"operationId":"getRevisionRetention","summary":"Review owner-only safe revision retirement eligibility","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"revisionId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetentionHint"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"operationId":"requestRevisionRetirement","summary":"Request eligible unpinned revision file retirement","tags":["Artifacts"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"revisionId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetentionInput"}}}},"x-max-request-bytes":16384,"responses":{"202":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetentionReceipt"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/collections":{"get":{"operationId":"listCollections","summary":"List a page of authorized collection policies","tags":["Runtime data"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"includeAccess","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"default":"false"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1024},"description":"Opaque artifact/user-scoped continuation cursor. Reuse without editing."}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionList"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"operationId":"defineCollection","summary":"Define a bounded collection policy","tags":["Runtime data"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefineCollectionRequest"}}}},"x-max-request-bytes":16384,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionPolicy"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/collections/capabilities":{"get":{"operationId":"getDataCapabilities","summary":"Inspect supported data permission actions and presets","tags":["Runtime data"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataCapabilities"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/collections/{collection}/permissions":{"get":{"operationId":"getCollectionPermissions","summary":"Read advisory collection permissions and lock state","tags":["Runtime data"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionAccess"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"patch":{"operationId":"updateCollectionPermissions","summary":"Apply the exact reviewed shared collection permissions","tags":["Runtime data"],"description":"Owner-only, current artifact:manage authority, reviewed policy digest, explicit new public action acknowledgments and idempotency are required. A stale preview conflicts; existing records are affected.","security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCollectionPermissions"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionPolicy"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/collections/{collection}/permissions/preview":{"post":{"operationId":"previewCollectionPermissions","summary":"Preview an owner-requested shared collection permission change","tags":["Runtime data"],"description":"Read-only metadata preview. Binds current policy and proposed permissions without reading saved values.","security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewCollectionPermissions"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionPermissionsPreview"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/collections/{collection}/export":{"get":{"operationId":"exportCollection","summary":"Export current authorized subject records","tags":["Runtime data"],"description":"Viewer collections bind the current subject server-side. Submission collections cannot be read or exported by any role. Attachment entries are metadata only.","security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1024},"description":"Opaque, scoped continuation cursor. Reuse without editing."}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionExport"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/collections/{collection}/seeds":{"post":{"operationId":"seedCollection","summary":"Initialize a collection once using a reviewed digest","tags":["Runtime data"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeedPlan"}}}},"x-max-request-bytes":1048576,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"initialized":{"const":true},"digest":{"type":"string","maxLength":64,"pattern":"^[a-f0-9]{64}$"}},"required":["initialized","digest"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/collections/{collection}/migrations":{"get":{"operationId":"listMigrations","summary":"List bounded schema migration status","tags":["Runtime data"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1024},"description":"Opaque, scoped continuation cursor. Reuse without editing."}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/MigrationStatus"},"maxItems":50},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"operationId":"planMigration","summary":"Create a locked schema migration plan","tags":["Runtime data"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionMigrationPlan"}}}},"x-max-request-bytes":32768,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MigrationStatus"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/collections/{collection}/migrations/draft":{"post":{"operationId":"draftMigration","summary":"Compute a reviewable migration digest","tags":["Runtime data"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HttpMigrationDraft"}}}},"x-max-request-bytes":32768,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionMigrationPlan"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/collections/{collection}/migrations/{migrationId}":{"get":{"operationId":"getMigration","summary":"Read current migration status","tags":["Runtime data"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"migrationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MigrationStatus"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/collections/{collection}/migrations/{migrationId}/plan":{"get":{"operationId":"getMigrationPlan","summary":"Read the authorized persisted migration plan","tags":["Runtime data"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"migrationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionMigrationPlan"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/collections/{collection}/migrations/{migrationId}/approve":{"post":{"operationId":"approveMigration","summary":"Approve a digest-bound schema migration","tags":["Runtime data"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"migrationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MigrationApproval"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MigrationStatus"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/collections/{collection}/migrations/{migrationId}/advance":{"post":{"operationId":"advanceMigration","summary":"Advance a digest-bound schema migration","tags":["Runtime data"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"migrationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MigrationAdvance"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MigrationStatus"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/collections/{collection}/migrations/{migrationId}/recover":{"post":{"operationId":"recoverMigration","summary":"Recover a digest-bound schema migration","tags":["Runtime data"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"migrationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MigrationAdvance"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MigrationStatus"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/data/{collection}":{"get":{"operationId":"listRecords","summary":"List current authorized subject records","tags":["Runtime data"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":1024},"description":"Opaque, scoped continuation cursor. Reuse without editing."}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/DataRecord"},"maxItems":50},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"operationId":"submitRecord","summary":"Submit without permission to read other submissions","tags":["Runtime data"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HttpRecordMutation"}}}},"x-max-request-bytes":32768,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionReceipt"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/data/{collection}/{key}":{"get":{"operationId":"getRecord","summary":"Read a current subject record","tags":["Runtime data"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"key","in":"path","required":true,"schema":{"$ref":"#/components/schemas/RecordKey"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/DataRecord"},{"type":"null"}]}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"put":{"operationId":"putRecord","summary":"Create absent or replace an expected record generation","tags":["Runtime data"],"description":"If-Match: \"none\" requires Add permission and creates only if absent. Shared caller-keyed creation also requires unconditional Read and current data:read authority; otherwise SERVER_KEY_REQUIRED is returned before key lookup. Use server-keyed POST submission for write-only or creator-only shared creation under Add alone. Updates require the quoted current etag and Edit permission. The result contains a receipt and a record only under current Read permission. Records persist across republishing and slugs.","security":[{},{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"key","in":"path","required":true,"schema":{"$ref":"#/components/schemas/RecordKey"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HttpRecordMutation"}}}},"x-max-request-bytes":32768,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataWriteResult"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"delete":{"operationId":"deleteRecord","summary":"Delete an expected record generation","tags":["Runtime data"],"description":"Requires a non-null quoted current etag; If-Match: \"none\" is rejected. Attachments are bound to the record generation.","security":[{},{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"key","in":"path","required":true,"schema":{"$ref":"#/components/schemas/RecordKey"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordDeletion"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/data/{collection}/{key}/attachments":{"get":{"operationId":"listAttachments","summary":"List up to four currently authorized record attachments","tags":["Runtime data"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"key","in":"path","required":true,"schema":{"$ref":"#/components/schemas/RecordKey"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Attachment"},"maxItems":4}},"required":["items"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"post":{"operationId":"prepareAttachment","summary":"Reserve private attachment bytes for this record generation","tags":["Runtime data"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"key","in":"path","required":true,"schema":{"$ref":"#/components/schemas/RecordKey"}},{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/IfMatch"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttachmentInput"}}}},"x-max-request-bytes":16384,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Attachment"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/data/{collection}/{key}/attachments/{attachmentId}":{"get":{"operationId":"getAttachment","summary":"Read authorized attachment metadata","tags":["Runtime data"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"key","in":"path","required":true,"schema":{"$ref":"#/components/schemas/RecordKey"}},{"name":"attachmentId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Attachment"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"delete":{"operationId":"deleteAttachment","summary":"Delete the current generation's private attachment","tags":["Runtime data"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"key","in":"path","required":true,"schema":{"$ref":"#/components/schemas/RecordKey"}},{"name":"attachmentId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Attachment"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/data/{collection}/{key}/attachments/{attachmentId}/content":{"put":{"operationId":"transferAttachment","summary":"Stream the reserved attachment under current record policy","tags":["Runtime data"],"description":"Current identity, collection permission, record generation, streamed length, digest, and reservation are checked. Upload-Capability does not authorize this endpoint.","security":[{},{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"key","in":"path","required":true,"schema":{"$ref":"#/components/schemas/RecordKey"}},{"name":"attachmentId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"x-max-request-bytes":2097152,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Attachment"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"get":{"operationId":"downloadAttachment","summary":"Read private bytes after current record authorization","tags":["Runtime data"],"security":[{},{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"collection","in":"path","required":true,"schema":{"type":"string","maxLength":48,"pattern":"^[a-z][a-z0-9_-]{0,47}$"}},{"name":"key","in":"path","required":true,"schema":{"$ref":"#/components/schemas/RecordKey"}},{"name":"attachmentId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"image/png":{"schema":{"type":"string","format":"binary","x-max-bytes":2097152}},"image/jpeg":{"schema":{"type":"string","format":"binary","x-max-bytes":2097152}},"image/webp":{"schema":{"type":"string","format":"binary","x-max-bytes":2097152}},"application/pdf":{"schema":{"type":"string","format":"binary","x-max-bytes":2097152}},"text/plain":{"schema":{"type":"string","format":"binary","x-max-bytes":2097152}},"application/octet-stream":{"schema":{"type":"string","format":"binary","x-max-bytes":2097152}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/workspaces/{workspaceId}/usage":{"get":{"operationId":"getWorkspaceUsage","summary":"Read aggregate workspace capacity as an owner or admin","tags":["Operations"],"security":[{"WebSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceUsage"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/artifacts/{artifactId}/reports":{"post":{"operationId":"reportArtifact","summary":"Report abuse from a verified signed-in account","tags":["Operations"],"security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbuseReportInput"}}}},"x-max-request-bytes":16384,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbuseReportReceipt"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/operations/mfa":{"get":{"operationId":"getOperatorMfa","summary":"Read current staff second-factor status","tags":["Operations"],"description":"Requires the explicit staff allowlist and a fresh verified web session. Status never includes factor secrets, codes or a caller-reusable proof.","security":[{"WebSession":[]}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorMfaStatus"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session"]}},"/api/v1/operations/mfa/enroll":{"post":{"operationId":"enrollOperatorMfa","summary":"Begin maintained authenticator enrollment","tags":["Operations"],"description":"Requires the explicit staff allowlist, fresh verified web session and exact mutation Origin. Existing verified-factor lifecycle changes additionally require live session/factor-bound MFA proof. Secrets are returned only to this authorized session and must never be logged or persisted in browser storage; responses are non-cacheable. Factor verification is rate-limited and replay-guarded. No caller-supplied user, session or authority is accepted.","security":[{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"x-max-request-bytes":4096,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorMfaEnrollment"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","current-second-factor-for-verified-factor-lifecycle"]}},"/api/v1/operations/mfa/setup-key":{"post":{"operationId":"getOperatorMfaKey","summary":"Read the pending authenticator setup key","tags":["Operations"],"description":"Requires the explicit staff allowlist, fresh verified web session and exact mutation Origin. Existing verified-factor lifecycle changes additionally require live session/factor-bound MFA proof. Secrets are returned only to this authorized session and must never be logged or persisted in browser storage; responses are non-cacheable. Factor verification is rate-limited and replay-guarded. No caller-supplied user, session or authority is accepted.","security":[{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"x-max-request-bytes":4096,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorMfaKey"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","current-second-factor-for-verified-factor-lifecycle"]}},"/api/v1/operations/mfa/verify":{"post":{"operationId":"verifyOperatorMfa","summary":"Verify the maintained authenticator and establish bounded staff proof","tags":["Operations"],"description":"Requires the explicit staff allowlist, fresh verified web session and exact mutation Origin. Existing verified-factor lifecycle changes additionally require live session/factor-bound MFA proof. Secrets are returned only to this authorized session and must never be logged or persisted in browser storage; responses are non-cacheable. Factor verification is rate-limited and replay-guarded. No caller-supplied user, session or authority is accepted.","security":[{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorMfaCode"}}}},"x-max-request-bytes":4096,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"verified"}},"required":["status"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","current-second-factor-for-verified-factor-lifecycle"]}},"/api/v1/operations/mfa/recover":{"post":{"operationId":"recoverOperatorMfa","summary":"Consume a maintained single-use recovery code","tags":["Operations"],"description":"Requires the explicit staff allowlist, fresh verified web session and exact mutation Origin. Existing verified-factor lifecycle changes additionally require live session/factor-bound MFA proof. Secrets are returned only to this authorized session and must never be logged or persisted in browser storage; responses are non-cacheable. Factor verification is rate-limited and replay-guarded. No caller-supplied user, session or authority is accepted.","security":[{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9-]+$","x-sensitive":true}},"required":["code"],"additionalProperties":false}}}},"x-max-request-bytes":4096,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"verified"}},"required":["status"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","current-second-factor-for-verified-factor-lifecycle"]}},"/api/v1/operations/mfa/disable":{"post":{"operationId":"disableOperatorMfa","summary":"Disable the factor after current second-factor verification","tags":["Operations"],"description":"Requires the explicit staff allowlist, fresh verified web session and exact mutation Origin. Existing verified-factor lifecycle changes additionally require live session/factor-bound MFA proof. Secrets are returned only to this authorized session and must never be logged or persisted in browser storage; responses are non-cacheable. Factor verification is rate-limited and replay-guarded. No caller-supplied user, session or authority is accepted.","security":[{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"x-max-request-bytes":4096,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"disabled"}},"required":["status"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","current-second-factor-for-verified-factor-lifecycle"]}},"/api/v1/operations/mfa/backup-codes":{"post":{"operationId":"rotateOperatorMfaBackupCodes","summary":"Rotate recovery codes after current second-factor verification","tags":["Operations"],"description":"Requires the explicit staff allowlist, fresh verified web session and exact mutation Origin. Existing verified-factor lifecycle changes additionally require live session/factor-bound MFA proof. Secrets are returned only to this authorized session and must never be logged or persisted in browser storage; responses are non-cacheable. Factor verification is rate-limited and replay-guarded. No caller-supplied user, session or authority is accepted.","security":[{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"x-max-request-bytes":4096,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorMfaBackupCodes"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","current-second-factor-for-verified-factor-lifecycle"]}},"/api/v1/operations/access":{"get":{"operationId":"getOperatorAccess","summary":"Check current bounded operator authority","tags":["Operations"],"description":"Requires a verified web account, session created within five minutes, server-side operator allowlist, and recent server-side MFA proof bound to the live session and verified factor. An explicitly configured legacy Access profile may supply equivalent externally enforced proof. Authority expires within sixty seconds and every mutation rechecks it.","security":[{"WebSession":[]}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperatorAccess"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","live-session-and-factor-bound-second-factor-proof"]}},"/api/v1/operations/jobs":{"get":{"operationId":"listOperationJobs","summary":"List operational jobs without private payloads","tags":["Operations"],"description":"Requires a verified web account, session created within five minutes, server-side operator allowlist, and recent server-side MFA proof bound to the live session and verified factor. An explicitly configured legacy Access profile may supply equivalent externally enforced proof. Authority expires within sixty seconds and every mutation rechecks it.","security":[{"WebSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":180},"description":"Opaque, scoped continuation cursor. Reuse without editing."},{"name":"state","in":"query","required":false,"schema":{"enum":["pending","running","done","dead"]}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/OperationJob"},"maxItems":50},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","live-session-and-factor-bound-second-factor-proof"]}},"/api/v1/operations/reports":{"get":{"operationId":"listAbuseReports","summary":"List bounded abuse report metadata","tags":["Operations"],"description":"Requires a verified web account, session created within five minutes, server-side operator allowlist, and recent server-side MFA proof bound to the live session and verified factor. An explicitly configured legacy Access profile may supply equivalent externally enforced proof. Authority expires within sixty seconds and every mutation rechecks it.","security":[{"WebSession":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":36},"description":"Opaque, scoped continuation cursor. Reuse without editing."},{"name":"resolved","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"default":"false"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/OperationReport"},"maxItems":50},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","live-session-and-factor-bound-second-factor-proof"]}},"/api/v1/operations/workspaces/{workspaceId}/audit":{"get":{"operationId":"getWorkspaceAudit","summary":"Read bounded audit metadata","tags":["Operations"],"description":"Requires a verified web account, session created within five minutes, server-side operator allowlist, and recent server-side MFA proof bound to the live session and verified factor. An explicitly configured legacy Access profile may supply equivalent externally enforced proof. Authority expires within sixty seconds and every mutation rechecks it.","security":[{"WebSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":180},"description":"Opaque, scoped continuation cursor. Reuse without editing."}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/OperationAudit"},"maxItems":50},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","live-session-and-factor-bound-second-factor-proof"]}},"/api/v1/operations/jobs/{jobId}/retry":{"post":{"operationId":"retryOperationJob","summary":"Queue an eligible failed job retry","tags":["Operations"],"description":"Requires a verified web account, session created within five minutes, server-side operator allowlist, and recent server-side MFA proof bound to the live session and verified factor. An explicitly configured legacy Access profile may supply equivalent externally enforced proof. Authority expires within sixty seconds and every mutation rechecks it.","security":[{"WebSession":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","maxLength":180,"minLength":1}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationReason"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationReceipt"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","live-session-and-factor-bound-second-factor-proof"]}},"/api/v1/operations/reports/{reportId}/review":{"post":{"operationId":"reviewAbuseReport","summary":"Record an explicit abuse report decision","tags":["Operations"],"description":"Requires a verified web account, session created within five minutes, server-side operator allowlist, and recent server-side MFA proof bound to the live session and verified factor. An explicitly configured legacy Access profile may supply equivalent externally enforced proof. Authority expires within sixty seconds and every mutation rechecks it.","security":[{"WebSession":[]}],"parameters":[{"name":"reportId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportReviewInput"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationReceipt"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","live-session-and-factor-bound-second-factor-proof"]}},"/api/v1/operations/artifacts/{artifactId}/suspension":{"patch":{"operationId":"setArtifactSuspension","summary":"Suspend or restore an artifact with an audited reason","tags":["Operations"],"description":"Requires a verified web account, session created within five minutes, server-side operator allowlist, and recent server-side MFA proof bound to the live session and verified factor. An explicitly configured legacy Access profile may supply equivalent externally enforced proof. Authority expires within sixty seconds and every mutation rechecks it.","security":[{"WebSession":[]}],"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuspensionInput"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationReceipt"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","live-session-and-factor-bound-second-factor-proof"]}},"/api/v1/operations/workspaces/{workspaceId}/suspension":{"patch":{"operationId":"setWorkspaceSuspension","summary":"Suspend or restore a workspace with an audited reason","tags":["Operations"],"description":"Requires a verified web account, session created within five minutes, server-side operator allowlist, and recent server-side MFA proof bound to the live session and verified factor. An explicitly configured legacy Access profile may supply equivalent externally enforced proof. Authority expires within sixty seconds and every mutation rechecks it.","security":[{"WebSession":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Id"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuspensionInput"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationReceipt"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","live-session-and-factor-bound-second-factor-proof"]}},"/api/v1/operations/mcp/clients":{"post":{"operationId":"registerMcpClient","summary":"Register an explicitly configured public MCP OAuth client","tags":["Operations"],"description":"Requires a verified web account, session created within five minutes, server-side operator allowlist, and recent server-side MFA proof bound to the live session and verified factor. An explicitly configured legacy Access profile may supply equivalent externally enforced proof. Authority expires within sixty seconds and every mutation rechecks it.","security":[{"WebSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterMcpClient"}}}},"x-max-request-bytes":16384,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisteredMcpClient"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","live-session-and-factor-bound-second-factor-proof"]}},"/api/v1/operations/mcp/clients/{clientId}/disable":{"post":{"operationId":"disableMcpClient","summary":"Disable a registered MCP client and its connection grants","tags":["Operations"],"description":"Requires a verified web account, session created within five minutes, server-side operator allowlist, and recent server-side MFA proof bound to the live session and verified factor. An explicitly configured legacy Access profile may supply equivalent externally enforced proof. Authority expires within sixty seconds and every mutation rechecks it.","security":[{"WebSession":[]}],"parameters":[{"name":"clientId","in":"path","required":true,"schema":{"type":"string","maxLength":128,"minLength":1}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HttpDisableMcpClient"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisabledMcpClient"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","live-session-and-factor-bound-second-factor-proof"]}},"/api/v1/operations/mcp/introspection":{"post":{"operationId":"initializeMcpIntrospection","summary":"Initialize the introspection client from environment credentials","tags":["Operations"],"description":"Requires a verified web account, session created within five minutes, server-side operator allowlist, and recent server-side MFA proof bound to the live session and verified factor. An explicitly configured legacy Access profile may supply equivalent externally enforced proof. Authority expires within sixty seconds and every mutation rechecks it.","security":[{"WebSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitializeMcpIntrospectionClient"}}}},"x-max-request-bytes":16384,"responses":{"201":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitializedMcpIntrospectionClient"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"x-operator-requirements":["server-side-allowlist","fresh-verified-web-session","live-session-and-factor-bound-second-factor-proof"],"x-credential-source":"Environment only; no secret is accepted in or returned by this API."}},"/api/v1/oauth/login":{"post":{"operationId":"beginOAuthLogin","summary":"Bind a signed provider request to this browser","tags":["OAuth browser commands"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthSignedQuery"}}}},"x-max-request-bytes":12288,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthLogin"}}},"headers":{"Set-Cookie":{"description":"Sets a short-lived HttpOnly SameSite=Lax browser binding; secure outside local/test.","schema":{"type":"string"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/oauth/continue":{"post":{"operationId":"continueOAuthLogin","summary":"Resume the same browser's request after sign-in","tags":["OAuth browser commands"],"description":"Requires the corresponding browser binding cookie as well as the application session. Clears the one-use binding cookie.","security":[{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthContinueInput"}}}},"x-max-request-bytes":16384,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthRedirect"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/oauth/consent":{"post":{"operationId":"beginOAuthConsent","summary":"Review a signature-verified workspace-scoped grant","tags":["OAuth browser commands"],"security":[{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthSignedQuery"}}}},"x-max-request-bytes":12288,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthConsentContext"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/oauth/deny":{"post":{"operationId":"denyOAuthConsent","summary":"Reject a validated request without creating a workspace grant","tags":["OAuth browser commands"],"description":"Requires the signed provider request, matching context, current user and session. The maintained provider returns access_denied and original state only to the validated callback.","security":[{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthDeny"}}}},"x-max-request-bytes":12288,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthRedirect"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/oauth/confirm":{"post":{"operationId":"confirmOAuthConsent","summary":"Approve a narrowed workspace grant through the maintained provider","tags":["OAuth browser commands"],"security":[{"WebSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HttpOAuthConfirm"}}}},"x-max-request-bytes":12288,"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthRedirect"}}}},"400":{"description":"Malformed input, invalid cursor, or missing idempotency key.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ApiError"},{"$ref":"#/components/schemas/OAuthProviderError"}]}}}},"401":{"description":"Sign in with a valid application session.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ApiError"},{"$ref":"#/components/schemas/OAuthProviderError"}]}}}},"403":{"description":"Origin, host, session freshness, or privileged access requirements failed.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ApiError"},{"$ref":"#/components/schemas/OAuthProviderError"}]}}}},"404":{"description":"Resource unavailable. Protected resources may use 404 to avoid enumeration.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ApiError"},{"$ref":"#/components/schemas/OAuthProviderError"}]}}}},"409":{"description":"State, idempotency payload, quota reservation, or policy conflict.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ApiError"},{"$ref":"#/components/schemas/OAuthProviderError"}]}}}},"412":{"description":"The expected state changed; refresh before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The streamed request exceeds its bounded size.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"415":{"description":"Unsupported request content type.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"428":{"description":"Required If-Match header missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Rate, record, storage, or retry receipt capacity reached.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ApiError"},{"$ref":"#/components/schemas/OAuthProviderError"}]}}},"headers":{"Retry-After":{"description":"When supplied, bounded retry delay in seconds.","schema":{"type":"integer","minimum":1,"maximum":60}}}},"500":{"description":"Unexpected service error; no private implementation details are returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"A required environment configuration or provider is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"components":{"securitySchemes":{"WebSession":{"type":"apiKey","in":"cookie","name":"pagesend.session_token","description":"Better Auth HttpOnly application session cookie. Secure environments use __Secure-pagesend.session_token. No web Bearer token fallback. Public artifact reads may omit the session, but private/team policies still apply. Unsafe first-party cookie requests must have the exact app Origin and must not be cross-site."},"OperatorAccess":{"type":"apiKey","in":"header","name":"Cf-Access-Jwt-Assertion","description":"Optional legacy externally enforced Access/MFA profile for an explicitly configured environment. The combined deployment uses server-stored session/factor-bound Better Auth MFA proof instead; callers cannot supply that proof as an HTTP header. Both profiles require WebSession, the current staff allowlist and a fresh verified session."},"UploadCapability":{"type":"apiKey","in":"header","name":"Upload-Capability","description":"One upload's short-lived 64-hex staging transfer capability. Permits only that upload's PUT content transfer. Never an application, content read, or MCP token."}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"$ref":"#/components/schemas/MutationKey"},"description":"Actor/workspace/operation scoped. Same key and payload replay the result under current authorization; a changed payload conflicts. Shared mutation receipts retain at least a 24-hour retry window while valid; privileged action accounting is separate. Do not reuse keys for different operations."},"IfMatch":{"name":"If-Match","in":"header","required":true,"schema":{"type":"string","pattern":"^\"[a-zA-Z0-9_-]{1,128}\"$"},"description":"Quoted current publication token or record etag. The literal \"none\" represents absent state for creation/first publish. Missing is 428; stale is 412. Record deletion requires a non-null etag."}},"schemas":{"LaunchTermsAcceptance":{"type":"object","properties":{"version":{"type":"string","pattern":"^[a-z0-9][a-z0-9.-]{0,63}$"},"agreed":{"type":"boolean","const":true},"reviewToken":{"type":"string","pattern":"^[a-zA-Z0-9_-]{43}$"}},"required":["version","agreed","reviewToken"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/launch-policy.ts#LaunchTermsAcceptance","x-schema-io":"input"},"LaunchTermsStatus":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"disabled"}},"required":["status"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"required"},"version":{"type":"string","pattern":"^[a-z0-9][a-z0-9.-]{0,63}$"},"reviewToken":{"type":"string","pattern":"^[a-zA-Z0-9_-]{43}$"}},"required":["status","version","reviewToken"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","const":"accepted"},"version":{"type":"string","pattern":"^[a-z0-9][a-z0-9.-]{0,63}$"},"acceptedAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["status","version","acceptedAt"],"additionalProperties":false}],"x-runtime-schema":"packages/contracts/src/launch-policy.ts#LaunchTermsStatus","x-schema-io":"output"},"ArtifactSeoSnapshot":{"type":"object","properties":{"searchEnabled":{"type":"boolean"},"routes":{"maxItems":256,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":2162,"format":"starts_with","pattern":"^\\/.*"},"title":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":320},"language":{"type":"string","maxLength":64},"noindex":{"type":"boolean"}},"required":["path"],"additionalProperties":false}},"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"token":{"type":"string","minLength":1,"maxLength":128},"deploymentEnabled":{"type":"boolean"},"sourceRoutes":{"maxItems":384,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":2162,"format":"starts_with","pattern":"^\\/.*"},"title":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":320},"language":{"type":"string","maxLength":64},"noindex":{"type":"boolean"}},"required":["path","title","description","language","noindex"],"additionalProperties":false}}},"required":["searchEnabled","routes","artifactId","token","deploymentEnabled","sourceRoutes"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/seo.ts#ArtifactSeoSnapshot","x-schema-io":"output"},"SeoUpdateBody":{"type":"object","properties":{"searchEnabled":{"type":"boolean"},"routes":{"maxItems":256,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":2162,"format":"starts_with","pattern":"^\\/.*"},"title":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":320},"language":{"type":"string","maxLength":64},"noindex":{"type":"boolean"}},"required":["path"],"additionalProperties":false}}},"required":["routes"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/seo.ts#SeoUpdate","x-schema-io":"input"},"ArtifactListPage":{"type":"object","properties":{"items":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"ownerId":{"type":"string"},"slug":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":1,"maxLength":160},"visibility":{"type":"string","enum":["private","team","public"]},"policyVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"activeRevisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"publicationToken":{"type":["string","null"]},"deletedAt":{"type":["number","null"]},"suspendedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":"number"}},"required":["id","workspaceId","ownerId","slug","title","visibility","policyVersion","activeRevisionId","publicationToken","deletedAt","suspendedAt","createdAt","updatedAt"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}]},"ownerNames":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":128},"additionalProperties":{"type":"string","maxLength":160}},"capabilities":{"type":"object","propertyNames":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"additionalProperties":{"maxItems":7,"type":"array","items":{"type":"string","enum":["artifact:read","artifact:publish","artifact:manage","artifact:visibility","data:read","data:write","data:submit"]}}}},"required":["items","nextCursor"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/lifecycle.ts#ArtifactListPage","x-schema-io":"output"},"CollectionList":{"type":"object","properties":{"items":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"policy":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,47}$"},"schemaVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"scope":{"type":"string","enum":["viewer","shared","submission"]},"permissionsVersion":{"type":"number","const":2},"permissions":{"type":"object","properties":{"read":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"add":{"type":"string","enum":["none","owner","members","authenticated","anyone"]},"edit":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"delete":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]}},"required":["read","add","edit","delete"],"additionalProperties":false},"maxRecords":{"default":1000,"type":"integer","exclusiveMinimum":0,"maximum":1000},"maxBytes":{"default":16384,"type":"integer","exclusiveMinimum":0,"maximum":16384},"schema":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","enum":["string","number","boolean","object","array","null"]}}},"required":["name","schemaVersion","scope","permissionsVersion","permissions","maxRecords","maxBytes","schema"],"additionalProperties":false},"migrationState":{"type":"string","minLength":1,"maxLength":48},"access":{"type":"object","properties":{"read":{"type":"string","enum":["allowed","denied","creator"]},"add":{"type":"string","enum":["allowed","denied","creator"]},"edit":{"type":"string","enum":["allowed","denied","creator"]},"delete":{"type":"string","enum":["allowed","denied","creator"]},"migrate":{"type":"boolean"},"migrationRead":{"type":"boolean"},"locked":{"type":"boolean"}},"required":["read","add","edit","delete","migrate","migrationRead","locked"],"additionalProperties":false}},"required":["policy","migrationState"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/authoring.ts#CollectionListing","x-schema-io":"output"},"CollectionAccessHints":{"type":"object","properties":{"read":{"type":"string","enum":["allowed","denied","creator"]},"add":{"type":"string","enum":["allowed","denied","creator"]},"edit":{"type":"string","enum":["allowed","denied","creator"]},"delete":{"type":"string","enum":["allowed","denied","creator"]},"migrate":{"type":"boolean"},"migrationRead":{"type":"boolean"},"locked":{"type":"boolean"}},"required":["read","add","edit","delete","migrate","migrationRead","locked"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/authoring.ts#CollectionAccessHints","x-schema-io":"output"},"ArtifactCreated":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"ownerId":{"type":"string"},"slug":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":1,"maxLength":160},"visibility":{"type":"string","enum":["private","team","public"]},"policyVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"activeRevisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"publicationToken":{"type":["string","null"]},"deletedAt":{"type":["number","null"]},"suspendedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":"number"},"capabilities":{"maxItems":7,"type":"array","items":{"type":"string","enum":["artifact:read","artifact:publish","artifact:manage","artifact:visibility","data:read","data:write","data:submit"]}}},"required":["id","workspaceId","ownerId","slug","title","visibility","policyVersion","activeRevisionId","publicationToken","deletedAt","suspendedAt","createdAt","updatedAt","capabilities"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/performance.ts#ArtifactCreated","x-schema-io":"output"},"ArtifactManagement":{"type":"object","properties":{"artifact":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"ownerId":{"type":"string"},"slug":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":1,"maxLength":160},"visibility":{"type":"string","enum":["private","team","public"]},"policyVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"activeRevisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"publicationToken":{"type":["string","null"]},"deletedAt":{"type":["number","null"]},"suspendedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":"number"}},"required":["id","workspaceId","ownerId","slug","title","visibility","policyVersion","activeRevisionId","publicationToken","deletedAt","suspendedAt","createdAt","updatedAt"],"additionalProperties":false},"head":{"anyOf":[{"type":"object","properties":{"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"publicationToken":{"type":"string","minLength":1},"canonicalUrl":{"type":"string"},"visibility":{"type":"string","enum":["private","team","public"]},"sequence":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["artifactId","revisionId","publicationToken","canonicalUrl","visibility","sequence"],"additionalProperties":false},{"type":"null"}]},"capabilities":{"maxItems":7,"type":"array","items":{"type":"string","enum":["artifact:read","artifact:publish","artifact:manage","artifact:visibility","data:read","data:write","data:submit"]}}},"required":["artifact","head","capabilities"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/performance.ts#ArtifactManagement","x-schema-io":"output"},"RenderAccess":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","revisionId","expiresAt"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/performance.ts#RenderAccess","x-schema-io":"output"},"ExportStatusResult":{"type":"object","properties":{"items":{"maxItems":25,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","enum":["pending","running","ready","failed"]},"createdAt":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expiresAt":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"downloadUrl":{"type":"string"}},"required":["id","artifactId","revisionId","state","createdAt","expiresAt"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/performance.ts#ExportStatusResult","x-schema-io":"output"},"ExportStatusInput":{"type":"object","properties":{"ids":{"minItems":1,"maxItems":25,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["ids"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/performance.ts#ExportStatusInput","x-schema-io":"input"},"PageInvitationInput":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"expectedPolicyVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"recipientName":{"type":"string","maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]*$"}},"required":["email","expectedPolicyVersion"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/sharing.ts#PageInvitationInput","x-schema-io":"input"},"CancelPageInvitationInput":{"type":"object","properties":{"expectedPolicyVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["expectedPolicyVersion"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/sharing.ts#CancelPageInvitationInput","x-schema-io":"input"},"AcceptPageInvitationInput":{"type":"object","properties":{"continuationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["continuationId"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/sharing.ts#AcceptPageInvitationInput","x-schema-io":"input"},"PageInvitationSummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","sent"]},"recipientName":{"type":"string","minLength":1,"maxLength":120}},"required":["id","email","expiresAt","status"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/sharing.ts#PageInvitationSummary","x-schema-io":"output"},"PageInvitationPage":{"type":"object","properties":{"items":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","sent"]},"recipientName":{"type":"string","minLength":1,"maxLength":120}},"required":["id","email","expiresAt","status"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/sharing.ts#PageInvitationPage","x-schema-io":"output"},"PageInvitationResult":{"type":"object","properties":{"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"policyVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"visibility":{"type":"string","enum":["private","team","public"]},"invitation":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","sent"]},"recipientName":{"type":"string","minLength":1,"maxLength":120}},"required":["id","email","expiresAt","status"],"additionalProperties":false}},"required":["artifactId","policyVersion","visibility","invitation"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/sharing.ts#PageInvitationResult","x-schema-io":"output"},"AcceptedPageInvitation":{"type":"object","properties":{"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"canonicalUrl":{"type":"string","format":"uri"}},"required":["artifactId","canonicalUrl"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/sharing.ts#AcceptedPageInvitation","x-schema-io":"output"},"Id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","x-runtime-schema":"packages/contracts/src/index.ts#Id","x-schema-io":"output"},"Slug":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","x-runtime-schema":"packages/contracts/src/index.ts#Slug","x-schema-io":"output","description":"Reserved names and workspace-specific reservations are additionally enforced by runtime refinements; the regex alone does not confer availability."},"Visibility":{"type":"string","enum":["private","team","public"],"x-runtime-schema":"packages/contracts/src/index.ts#Visibility","x-schema-io":"output"},"Role":{"type":"string","enum":["owner","admin","editor","viewer"],"x-runtime-schema":"packages/contracts/src/index.ts#Role","x-schema-io":"output"},"Capability":{"type":"string","enum":["artifact:read","artifact:publish","artifact:manage","artifact:visibility","data:read","data:write","data:submit"],"x-runtime-schema":"packages/contracts/src/index.ts#Capability","x-schema-io":"output"},"WorkspaceMembership":{"type":"object","properties":{"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"userId":{"type":"string","minLength":1,"maxLength":128},"role":{"type":"string","enum":["owner","admin","editor","viewer"]}},"required":["workspaceId","userId","role"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#WorkspaceMembership","x-schema-io":"output"},"MutationKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{16,96}$","x-runtime-schema":"packages/contracts/src/index.ts#MutationKey","x-schema-io":"output"},"Artifact":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"ownerId":{"type":"string"},"slug":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":1,"maxLength":160},"visibility":{"type":"string","enum":["private","team","public"]},"policyVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"activeRevisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"publicationToken":{"type":["string","null"]},"deletedAt":{"type":["number","null"]},"suspendedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":"number"}},"required":["id","workspaceId","ownerId","slug","title","visibility","policyVersion","activeRevisionId","publicationToken","deletedAt","suspendedAt","createdAt","updatedAt"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#Artifact","x-schema-io":"output"},"UploadState":{"type":"string","enum":["uploading","uploaded","validating","ready","failed","cancelled"],"x-runtime-schema":"packages/contracts/src/index.ts#UploadState","x-schema-io":"output"},"FileEntry":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":240},"size":{"type":"integer","minimum":0,"maximum":4194304},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"contentType":{"type":"string","maxLength":128}},"required":["path","size","sha256","contentType"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#FileEntry","x-schema-io":"output"},"RouteManifest":{"type":"object","properties":{"mode":{"type":"string","enum":["static","spa"]},"entry":{"default":"index.html","type":"string"},"spaRoutes":{"default":[],"maxItems":128,"type":"array","items":{"type":"string","maxLength":240}},"seo":{"maxItems":256,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":2162,"format":"starts_with","pattern":"^\\/.*"},"title":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":320},"language":{"type":"string","maxLength":64},"noindex":{"type":"boolean"}},"required":["path"],"additionalProperties":false}}},"required":["mode","entry","spaRoutes"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#RouteManifest","x-schema-io":"output"},"BundleManifest":{"type":"object","properties":{"version":{"type":"number","const":1},"files":{"minItems":1,"maxItems":256,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":240},"size":{"type":"integer","minimum":0,"maximum":4194304},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"contentType":{"type":"string","maxLength":128}},"required":["path","size","sha256","contentType"],"additionalProperties":false}},"routing":{"type":"object","properties":{"mode":{"type":"string","enum":["static","spa"]},"entry":{"default":"index.html","type":"string"},"spaRoutes":{"default":[],"maxItems":128,"type":"array","items":{"type":"string","maxLength":240}},"seo":{"maxItems":256,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":2162,"format":"starts_with","pattern":"^\\/.*"},"title":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":320},"language":{"type":"string","maxLength":64},"noindex":{"type":"boolean"}},"required":["path"],"additionalProperties":false}}},"required":["mode","entry","spaRoutes"],"additionalProperties":false}},"required":["version","files","routing"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#BundleManifest","x-schema-io":"output"},"Revision":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"manifest":{"type":"object","properties":{"version":{"type":"number","const":1},"files":{"minItems":1,"maxItems":256,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":240},"size":{"type":"integer","minimum":0,"maximum":4194304},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"contentType":{"type":"string","maxLength":128}},"required":["path","size","sha256","contentType"],"additionalProperties":false}},"routing":{"type":"object","properties":{"mode":{"type":"string","enum":["static","spa"]},"entry":{"default":"index.html","type":"string"},"spaRoutes":{"default":[],"maxItems":128,"type":"array","items":{"type":"string","maxLength":240}},"seo":{"maxItems":256,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":2162,"format":"starts_with","pattern":"^\\/.*"},"title":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":320},"language":{"type":"string","maxLength":64},"noindex":{"type":"boolean"}},"required":["path"],"additionalProperties":false}}},"required":["mode","entry","spaRoutes"],"additionalProperties":false}},"required":["version","files","routing"],"additionalProperties":false},"state":{"type":"string","enum":["uploading","uploaded","validating","ready","failed","cancelled"]},"availability":{"type":"string","enum":["available","retiring","retired"]},"createdAt":{"type":"number"}},"required":["id","artifactId","manifest","state","createdAt"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#Revision","x-schema-io":"output"},"PublicationHead":{"type":"object","properties":{"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"publicationToken":{"type":"string","minLength":1},"canonicalUrl":{"type":"string"},"visibility":{"type":"string","enum":["private","team","public"]},"sequence":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["artifactId","revisionId","publicationToken","canonicalUrl","visibility","sequence"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#PublicationHead","x-schema-io":"output"},"UploadSession":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","enum":["uploading","uploaded","validating","ready","failed","cancelled"]},"reservedBytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"expiresAt":{"type":"number"},"revisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"error":{"type":["string","null"]}},"required":["id","artifactId","state","reservedBytes","expiresAt","revisionId","error"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#UploadSession","x-schema-io":"output"},"PreparedUpload":{"type":"object","properties":{"upload":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","enum":["uploading","uploaded","validating","ready","failed","cancelled"]},"reservedBytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"expiresAt":{"type":"number"},"revisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"error":{"type":["string","null"]}},"required":["id","artifactId","state","reservedBytes","expiresAt","revisionId","error"],"additionalProperties":false},"currentUpload":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","enum":["uploading","uploaded","validating","ready","failed","cancelled"]},"reservedBytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"expiresAt":{"type":"number"},"revisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"error":{"type":["string","null"]}},"required":["id","artifactId","state","reservedBytes","expiresAt","revisionId","error"],"additionalProperties":false},"transfer":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"token":{"type":"string","pattern":"^[0-9a-f]{64}$"},"expiresAt":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"method":{"type":"string","const":"PUT"}},"required":["url","token","expiresAt","method"],"additionalProperties":false}},"required":["upload","currentUpload","transfer"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#PreparedUpload","x-schema-io":"output"},"FinalizeResult":{"type":"object","properties":{"upload":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","enum":["uploading","uploaded","validating","ready","failed","cancelled"]},"reservedBytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"expiresAt":{"type":"number"},"revisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"error":{"type":["string","null"]}},"required":["id","artifactId","state","reservedBytes","expiresAt","revisionId","error"],"additionalProperties":false},"revision":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"manifest":{"type":"object","properties":{"version":{"type":"number","const":1},"files":{"minItems":1,"maxItems":256,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":240},"size":{"type":"integer","minimum":0,"maximum":4194304},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"contentType":{"type":"string","maxLength":128}},"required":["path","size","sha256","contentType"],"additionalProperties":false}},"routing":{"type":"object","properties":{"mode":{"type":"string","enum":["static","spa"]},"entry":{"default":"index.html","type":"string"},"spaRoutes":{"default":[],"maxItems":128,"type":"array","items":{"type":"string","maxLength":240}},"seo":{"maxItems":256,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":2162,"format":"starts_with","pattern":"^\\/.*"},"title":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":320},"language":{"type":"string","maxLength":64},"noindex":{"type":"boolean"}},"required":["path"],"additionalProperties":false}}},"required":["mode","entry","spaRoutes"],"additionalProperties":false}},"required":["version","files","routing"],"additionalProperties":false},"state":{"type":"string","enum":["uploading","uploaded","validating","ready","failed","cancelled"]},"availability":{"type":"string","enum":["available","retiring","retired"]},"createdAt":{"type":"number"}},"required":["id","artifactId","manifest","state","createdAt"],"additionalProperties":false}},"required":["upload","revision"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#FinalizeResult","x-schema-io":"output"},"PublishResult":{"type":"object","properties":{"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"publicationToken":{"type":"string","minLength":1},"canonicalUrl":{"type":"string"},"visibility":{"type":"string","enum":["private","team","public"]},"sequence":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"status":{"type":"string","const":"published"}},"required":["artifactId","revisionId","publicationToken","canonicalUrl","visibility","sequence","status"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#PublishResult","x-schema-io":"output"},"RenderSession":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"publicationToken":{"type":"string"},"policyVersion":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expiresAt":{"type":"number"},"contentUrl":{"type":"string"},"channel":{"type":"string","minLength":32}},"required":["id","artifactId","revisionId","publicationToken","policyVersion","expiresAt","contentUrl","channel"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#RenderSession","x-schema-io":"output"},"ViewerBootstrap":{"type":"object","properties":{"page":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string","minLength":1,"maxLength":160},"visibility":{"type":"string","enum":["private","team","public"]}},"required":["id","title","visibility"],"additionalProperties":false},"head":{"type":"object","properties":{"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"publicationToken":{"type":"string","minLength":1},"canonicalUrl":{"type":"string"},"visibility":{"type":"string","enum":["private","team","public"]},"sequence":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["artifactId","revisionId","publicationToken","canonicalUrl","visibility","sequence"],"additionalProperties":false},"renderSession":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"publicationToken":{"type":"string"},"policyVersion":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expiresAt":{"type":"number"},"contentUrl":{"type":"string"},"channel":{"type":"string","minLength":32}},"required":["id","artifactId","revisionId","publicationToken","policyVersion","expiresAt","contentUrl","channel"],"additionalProperties":false},"route":{"type":"object","properties":{"location":{"type":"object","properties":{"pathname":{"type":"string","maxLength":2048},"search":{"type":"string","maxLength":2048},"hash":{"type":"string","maxLength":2048}},"required":["pathname","search","hash"],"additionalProperties":false},"mode":{"type":"string","enum":["static","spa"]},"exists":{"type":"boolean"}},"required":["location","mode","exists"],"additionalProperties":false}},"required":["page","head","renderSession","route"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#ViewerBootstrap","x-schema-io":"output"},"PreviewSession":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"policyVersion":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expiresAt":{"type":"number"},"contentUrl":{"type":"string"},"channel":{"type":"string","minLength":32},"kind":{"type":"string","const":"preview"}},"required":["id","artifactId","revisionId","policyVersion","expiresAt","contentUrl","channel","kind"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#PreviewSession","x-schema-io":"output"},"CollectionPolicy":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,47}$"},"schemaVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"scope":{"type":"string","enum":["viewer","shared","submission"]},"permissionsVersion":{"type":"number","const":2},"permissions":{"type":"object","properties":{"read":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"add":{"type":"string","enum":["none","owner","members","authenticated","anyone"]},"edit":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"delete":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]}},"required":["read","add","edit","delete"],"additionalProperties":false},"maxRecords":{"default":1000,"type":"integer","exclusiveMinimum":0,"maximum":1000},"maxBytes":{"default":16384,"type":"integer","exclusiveMinimum":0,"maximum":16384},"schema":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","enum":["string","number","boolean","object","array","null"]}}},"required":["name","schemaVersion","scope","permissionsVersion","permissions","maxRecords","maxBytes","schema"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#CollectionPolicy","x-schema-io":"output"},"DataAction":{"type":"string","enum":["read","add","edit","delete"],"x-runtime-schema":"packages/contracts/src/index.ts#DataAction","x-schema-io":"output"},"DataAudience":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"],"x-runtime-schema":"packages/contracts/src/index.ts#DataAudience","x-schema-io":"output"},"DataPermissions":{"type":"object","properties":{"read":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"add":{"type":"string","enum":["none","owner","members","authenticated","anyone"]},"edit":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"delete":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]}},"required":["read","add","edit","delete"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#DataPermissions","x-schema-io":"output"},"DataRecord":{"type":"object","properties":{"key":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,96}$"},"value":{},"etag":{"type":"string"},"schemaVersion":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"number"},"updatedAt":{"type":"number"},"access":{"type":"object","properties":{"edit":{"type":"boolean"},"delete":{"type":"boolean"}},"required":["edit","delete"],"additionalProperties":false}},"required":["key","value","etag","schemaVersion","createdAt","updatedAt"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#DataRecord","x-schema-io":"output"},"DataWriteResult":{"type":"object","properties":{"receipt":{"type":"string","minLength":1,"maxLength":96},"etag":{"type":"string","minLength":1,"maxLength":128},"schemaVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"record":{"anyOf":[{"type":"object","properties":{"key":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,96}$"},"value":{},"etag":{"type":"string"},"schemaVersion":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"number"},"updatedAt":{"type":"number"},"access":{"type":"object","properties":{"edit":{"type":"boolean"},"delete":{"type":"boolean"}},"required":["edit","delete"],"additionalProperties":false}},"required":["key","value","etag","schemaVersion","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]}},"required":["receipt","etag","schemaVersion","record"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#DataWriteResult","x-schema-io":"output"},"ApiError":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"retryable":{"type":"boolean"},"fields":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["code","message","requestId","retryable"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#ApiError","x-schema-io":"output"},"AuditEvent":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"artifactId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"actorId":{"type":["string","null"]},"action":{"type":"string"},"createdAt":{"type":"number"},"requestId":{"type":"string"}},"required":["id","workspaceId","artifactId","actorId","action","createdAt","requestId"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#AuditEvent","x-schema-io":"output"},"PrepareUpload":{"type":"object","properties":{"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"format":{"type":"string","enum":["html","zip","folder"]},"declaredBytes":{"type":"integer","exclusiveMinimum":0,"maximum":16777216},"expandedBytes":{"type":"integer","exclusiveMinimum":0,"maximum":33554432},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"routing":{"type":"object","properties":{"mode":{"type":"string","enum":["static","spa"]},"entry":{"default":"index.html","type":"string"},"spaRoutes":{"default":[],"maxItems":128,"type":"array","items":{"type":"string","maxLength":240}},"seo":{"maxItems":256,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":2162,"format":"starts_with","pattern":"^\\/.*"},"title":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":320},"language":{"type":"string","maxLength":64},"noindex":{"type":"boolean"}},"required":["path"],"additionalProperties":false}}},"required":["mode"],"additionalProperties":false},"files":{"minItems":1,"maxItems":256,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":240},"size":{"type":"integer","minimum":0,"maximum":4194304},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["path","size","sha256"],"additionalProperties":false}}},"required":["artifactId","format","declaredBytes","expandedBytes","sha256","routing"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#PrepareUpload","x-schema-io":"input"},"CreateArtifact":{"type":"object","properties":{"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string","minLength":1,"maxLength":160},"slug":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},"required":["workspaceId","title","slug"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#CreateArtifact","x-schema-io":"input"},"PublishInput":{"type":"object","properties":{"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedPublicationToken":{"type":["string","null"]},"expectedPolicyVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expectedVisibility":{"type":"string","enum":["private","team","public"]}},"required":["revisionId","expectedPublicationToken","expectedPolicyVersion","expectedVisibility"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#PublishInput","x-schema-io":"input"},"AccessInput":{"type":"object","properties":{"visibility":{"type":"string","enum":["private","team","public"]},"expectedPolicyVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"confirmPublic":{"default":false,"type":"boolean"}},"required":["visibility","expectedPolicyVersion"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#AccessInput","x-schema-io":"input"},"Pagination":{"type":"object","properties":{"limit":{"default":25,"type":"integer","minimum":1,"maximum":50},"cursor":{"type":"string","maxLength":512},"search":{"default":"","type":"string","maxLength":120}},"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#Pagination","x-schema-io":"input"},"ViewerBootstrapRequest":{"type":"object","properties":{"workspace":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"slug":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"route":{"type":"string","minLength":1,"maxLength":2048}},"required":["workspace","slug","route"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#ViewerBootstrapRequest","x-schema-io":"input"},"DefineCollection":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,47}$"},"schemaVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"scope":{"type":"string","enum":["viewer","shared","submission"]},"permissionsVersion":{"type":"number","const":2},"permissions":{"type":"object","properties":{"read":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"add":{"type":"string","enum":["none","owner","members","authenticated","anyone"]},"edit":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"delete":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]}},"required":["read","add","edit","delete"],"additionalProperties":false},"maxRecords":{"default":1000,"type":"integer","exclusiveMinimum":0,"maximum":1000},"maxBytes":{"default":16384,"type":"integer","exclusiveMinimum":0,"maximum":16384},"schema":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","enum":["string","number","boolean","object","array","null"]}}},"required":["name","schemaVersion","scope","permissionsVersion","permissions"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/data.ts#DefineCollection","x-schema-io":"input"},"DefineCollectionRequest":{"type":"object","properties":{"policy":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,47}$"},"schemaVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"scope":{"type":"string","enum":["viewer","shared","submission"]},"permissionsVersion":{"type":"number","const":2},"permissions":{"type":"object","properties":{"read":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"add":{"type":"string","enum":["none","owner","members","authenticated","anyone"]},"edit":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"delete":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]}},"required":["read","add","edit","delete"],"additionalProperties":false},"maxRecords":{"default":1000,"type":"integer","exclusiveMinimum":0,"maximum":1000},"maxBytes":{"default":16384,"type":"integer","exclusiveMinimum":0,"maximum":16384},"schema":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","enum":["string","number","boolean","object","array","null"]}}},"required":["name","schemaVersion","scope","permissionsVersion","permissions"],"additionalProperties":false},"acknowledgedPublicActions":{"default":[],"maxItems":4,"type":"array","items":{"type":"string","enum":["read","add","edit","delete"]}}},"required":["policy"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/data.ts#DefineCollectionRequest","x-schema-io":"input"},"PreviewCollectionPermissions":{"type":"object","properties":{"permissions":{"type":"object","properties":{"read":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"add":{"type":"string","enum":["none","owner","members","authenticated","anyone"]},"edit":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"delete":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]}},"required":["read","add","edit","delete"],"additionalProperties":false}},"required":["permissions"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/data.ts#PreviewCollectionPermissions","x-schema-io":"input"},"UpdateCollectionPermissions":{"type":"object","properties":{"permissions":{"type":"object","properties":{"read":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"add":{"type":"string","enum":["none","owner","members","authenticated","anyone"]},"edit":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"delete":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]}},"required":["read","add","edit","delete"],"additionalProperties":false},"expectedPolicyDigest":{"type":"string","pattern":"^[0-9a-f]{64}$"},"reviewDigest":{"type":"string","pattern":"^[0-9a-f]{64}$"},"acknowledgedPublicActions":{"maxItems":4,"type":"array","items":{"type":"string","enum":["read","add","edit","delete"]}}},"required":["permissions","expectedPolicyDigest","reviewDigest","acknowledgedPublicActions"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/data.ts#UpdateCollectionPermissions","x-schema-io":"input"},"DataMutationInput":{"type":"object","properties":{"key":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,96}$"},"value":{},"expectedEtag":{"anyOf":[{"type":"string","minLength":1,"maxLength":128},{"type":"null"}]},"schemaVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["key","value","expectedEtag","schemaVersion"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/data.ts#DataMutationInput","x-schema-io":"input"},"SeedPlan":{"type":"object","properties":{"expectedSchemaVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"entries":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"key":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,96}$"},"value":{}},"required":["key","value"],"additionalProperties":false}},"digest":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["expectedSchemaVersion","entries","digest"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/data.ts#SeedPlan","x-schema-io":"input"},"CollectionMigrationPlan":{"type":"object","properties":{"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"targetVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expectedPolicyDigest":{"type":"string","pattern":"^[0-9a-f]{64}$"},"targetPolicy":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,47}$"},"schemaVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"scope":{"type":"string","enum":["viewer","shared","submission"]},"permissionsVersion":{"type":"number","const":2},"permissions":{"type":"object","properties":{"read":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"add":{"type":"string","enum":["none","owner","members","authenticated","anyone"]},"edit":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"delete":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]}},"required":["read","add","edit","delete"],"additionalProperties":false},"maxRecords":{"default":1000,"type":"integer","exclusiveMinimum":0,"maximum":1000},"maxBytes":{"default":16384,"type":"integer","exclusiveMinimum":0,"maximum":16384},"schema":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","enum":["string","number","boolean","object","array","null"]}}},"required":["name","schemaVersion","scope","permissionsVersion","permissions"],"additionalProperties":false},"steps":{"minItems":1,"maxItems":16,"type":"array","items":{"oneOf":[{"type":"object","properties":{"operation":{"type":"string","const":"add-default"},"field":{"type":"string","pattern":"^[a-zA-Z_][a-zA-Z0-9_]{0,63}$"},"value":{}},"required":["operation","field","value"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"rename-field"},"from":{"type":"string","pattern":"^[a-zA-Z_][a-zA-Z0-9_]{0,63}$"},"to":{"type":"string","pattern":"^[a-zA-Z_][a-zA-Z0-9_]{0,63}$"}},"required":["operation","from","to"],"additionalProperties":false}]}},"digest":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["expectedVersion","targetVersion","expectedPolicyDigest","targetPolicy","steps","digest"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/data.ts#CollectionMigrationPlan","x-schema-io":"input"},"AttachmentInput":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"contentType":{"type":"string","enum":["image/png","image/jpeg","image/webp","application/pdf","text/plain","application/octet-stream"]},"size":{"type":"integer","exclusiveMinimum":0,"maximum":2097152},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["name","contentType","size","sha256"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/data.ts#AttachmentInput","x-schema-io":"input"},"RecordKey":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,96}$","x-runtime-schema":"packages/contracts/src/data.ts#RecordKey","x-schema-io":"output"},"MigrationStep":{"oneOf":[{"type":"object","properties":{"operation":{"type":"string","const":"add-default"},"field":{"type":"string","pattern":"^[a-zA-Z_][a-zA-Z0-9_]{0,63}$"},"value":{}},"required":["operation","field","value"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"rename-field"},"from":{"type":"string","pattern":"^[a-zA-Z_][a-zA-Z0-9_]{0,63}$"},"to":{"type":"string","pattern":"^[a-zA-Z_][a-zA-Z0-9_]{0,63}$"}},"required":["operation","from","to"],"additionalProperties":false}],"x-runtime-schema":"packages/contracts/src/data.ts#MigrationStep","x-schema-io":"output"},"Attachment":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"key":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,96}$"},"name":{"type":"string"},"contentType":{"type":"string"},"size":{"type":"integer","minimum":0,"maximum":9007199254740991},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"state":{"type":"string","enum":["uploading","ready","failed","deleted"]}},"required":["id","key","name","contentType","size","sha256","state"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/data.ts#Attachment","x-schema-io":"output"},"DataCapabilities":{"type":"object","properties":{"enabled":{"type":"boolean"},"permissionsVersion":{"type":"number","const":2},"actions":{"minItems":4,"maxItems":4,"type":"array","items":{"type":"string","enum":["read","add","edit","delete"]}},"audiences":{"minItems":6,"maxItems":6,"type":"array","items":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]}},"presets":{"minItems":4,"maxItems":4,"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"scope":{"type":"string","enum":["viewer","shared","submission"]},"permissions":{"type":"object","properties":{"read":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"add":{"type":"string","enum":["none","owner","members","authenticated","anyone"]},"edit":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"delete":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]}},"required":["read","add","edit","delete"],"additionalProperties":false}},"required":["id","label","scope","permissions"],"additionalProperties":false}}},"required":["enabled","permissionsVersion","actions","audiences","presets"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/data.ts#DataCapabilities","x-schema-io":"output"},"CollectionPermissionsPreview":{"type":"object","properties":{"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"collection":{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,47}$"},"scope":{"type":"string","const":"shared"},"currentPermissions":{"type":"object","properties":{"read":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"add":{"type":"string","enum":["none","owner","members","authenticated","anyone"]},"edit":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"delete":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]}},"required":["read","add","edit","delete"],"additionalProperties":false},"targetPermissions":{"type":"object","properties":{"read":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"add":{"type":"string","enum":["none","owner","members","authenticated","anyone"]},"edit":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"delete":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]}},"required":["read","add","edit","delete"],"additionalProperties":false},"expectedPolicyDigest":{"type":"string","pattern":"^[0-9a-f]{64}$"},"reviewDigest":{"type":"string","pattern":"^[0-9a-f]{64}$"},"newPublicActions":{"maxItems":4,"type":"array","items":{"type":"string","enum":["read","add","edit","delete"]}},"affectsExistingRecords":{"type":"boolean","const":true}},"required":["artifactId","collection","scope","currentPermissions","targetPermissions","expectedPolicyDigest","reviewDigest","newPublicActions","affectsExistingRecords"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/data.ts#CollectionPermissionsPreview","x-schema-io":"output"},"ArtifactUpdate":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":160},"slug":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"expectedUpdatedAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["title","slug","expectedUpdatedAt"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/lifecycle.ts#ArtifactUpdate","x-schema-io":"input"},"ArtifactListQuery":{"type":"object","properties":{"limit":{"default":25,"type":"integer","minimum":1,"maximum":50},"cursor":{"type":"string","maxLength":2048},"search":{"default":"","type":"string","maxLength":120},"visibility":{"type":"string","enum":["private","team","public"]},"deleted":{"default":false,"type":"boolean"}},"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/lifecycle.ts#ArtifactListQuery","x-schema-io":"input"},"DuplicateArtifact":{"type":"object","properties":{"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string","minLength":1,"maxLength":160},"slug":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["workspaceId","title","slug"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/lifecycle.ts#DuplicateArtifact","x-schema-io":"input"},"ArtifactExportRequest":{"type":"object","properties":{"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/lifecycle.ts#ArtifactExportRequest","x-schema-io":"input"},"ScopeClosureRequest":{"type":"object","properties":{"confirm":{"type":"boolean","const":true},"confirmation":{"type":"string","minLength":1,"maxLength":254},"planDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["confirm","confirmation","planDigest"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/lifecycle.ts#ScopeClosureRequest","x-schema-io":"input","description":"confirm must be true. confirmation must exactly match the current plan label and planDigest must match the refreshed plan; service checks both under current scope authorization."},"ArtifactDeletion":{"type":"object","properties":{"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"deletedAt":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["artifactId","deletedAt"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/lifecycle.ts#ArtifactDeletion","x-schema-io":"output"},"ArtifactExport":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","enum":["pending","running","ready","failed"]},"createdAt":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expiresAt":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"downloadUrl":{"type":"string"}},"required":["id","artifactId","revisionId","state","createdAt","expiresAt"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/lifecycle.ts#ArtifactExport","x-schema-io":"output"},"ArtifactDuplicate":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sourceArtifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"targetArtifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"targetRevisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"state":{"type":"string","enum":["pending","running","ready","failed"]},"createdAt":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expiresAt":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["id","sourceArtifactId","targetArtifactId","targetRevisionId","state","createdAt","expiresAt"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/lifecycle.ts#ArtifactDuplicate","x-schema-io":"output"},"ScopeClosurePlan":{"type":"object","properties":{"kind":{"type":"string","enum":["account","workspace"]},"targetId":{"type":"string","minLength":1,"maxLength":255},"scopeVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"artifactCount":{"type":"integer","minimum":0,"maximum":100000},"workspaceCount":{"type":"integer","minimum":0,"maximum":100},"confirmationLabel":{"type":"string","minLength":1,"maxLength":254},"retentionDays":{"anyOf":[{"type":"integer","minimum":0,"maximum":365},{"type":"null"}]},"planDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["kind","targetId","scopeVersion","artifactCount","workspaceCount","confirmationLabel","retentionDays","planDigest"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/lifecycle.ts#ScopeClosurePlan","x-schema-io":"output"},"ScopeClosureReceipt":{"type":"object","properties":{"closureId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["account","workspace"]},"targetId":{"type":"string","minLength":1,"maxLength":255},"requestedAt":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"artifactCount":{"type":"integer","minimum":0,"maximum":100000},"workspaceCount":{"type":"integer","minimum":0,"maximum":100},"status":{"type":"string","const":"deletion-requested"}},"required":["closureId","kind","targetId","requestedAt","artifactCount","workspaceCount","status"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/lifecycle.ts#ScopeClosureReceipt","x-schema-io":"output"},"WorkspaceInput":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"slug":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},"required":["name","slug"],"additionalProperties":false,"x-runtime-schema":"packages/domain/identity/workspaces.ts#WorkspaceInput","x-schema-io":"input"},"InvitationInput":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"role":{"type":"string","enum":["admin","editor","viewer"]},"recipientName":{"type":"string","maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]*$"}},"required":["email","role"],"additionalProperties":false,"x-runtime-schema":"packages/domain/identity/workspaces.ts#InvitationInput","x-schema-io":"input"},"ConfirmOAuthConsent":{"type":"object","properties":{"contextId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"scopes":{"minItems":1,"maxItems":8,"type":"array","items":{"type":"string","enum":["artifact:read","artifact:publish","artifact:manage","artifact:visibility","data:read","data:write","data:submit","offline_access"]}}},"required":["contextId","workspaceId","scopes"],"additionalProperties":false,"x-runtime-schema":"packages/domain/identity/oauth-flow.ts#ConfirmOAuthConsent","x-schema-io":"input"},"ConnectionSummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resource":{"type":"string","format":"uri"},"scopes":{"maxItems":7,"type":"array","items":{"type":"string","enum":["artifact:read","artifact:publish","artifact:manage","artifact:visibility","data:read","data:write","data:submit"]}},"clientId":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}]},"clientName":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}]},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"revokedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"lastUsedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","workspaceId","resource","scopes","clientId","clientName","createdAt","expiresAt","revokedAt","lastUsedAt"],"additionalProperties":false,"x-runtime-schema":"packages/domain/integrations/connections.ts#ConnectionSummary","x-schema-io":"output"},"ConnectionPage":{"type":"object","properties":{"items":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resource":{"type":"string","format":"uri"},"scopes":{"maxItems":7,"type":"array","items":{"type":"string","enum":["artifact:read","artifact:publish","artifact:manage","artifact:visibility","data:read","data:write","data:submit"]}},"clientId":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}]},"clientName":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}]},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"revokedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"lastUsedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","workspaceId","resource","scopes","clientId","clientName","createdAt","expiresAt","revokedAt","lastUsedAt"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false,"x-runtime-schema":"packages/domain/integrations/connections.ts#ConnectionPage","x-schema-io":"output"},"ConnectionRevocation":{"type":"object","properties":{"connectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"revokedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","const":"revoked"}},"required":["connectionId","revokedAt","status"],"additionalProperties":false,"x-runtime-schema":"packages/domain/integrations/connections.ts#ConnectionRevocation","x-schema-io":"output"},"WorkspaceOverview":{"type":"object","properties":{"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"counts":{"type":"object","properties":{"all":{"type":"integer","minimum":0,"maximum":9007199254740991},"public":{"type":"integer","minimum":0,"maximum":9007199254740991},"private":{"type":"integer","minimum":0,"maximum":9007199254740991},"team":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["all","public","private","team"],"additionalProperties":false},"recentPages":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"ownerId":{"type":"string"},"slug":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":1,"maxLength":160},"visibility":{"type":"string","enum":["private","team","public"]},"policyVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"activeRevisionId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"publicationToken":{"type":["string","null"]},"deletedAt":{"type":["number","null"]},"suspendedAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":"number"}},"required":["id","workspaceId","ownerId","slug","title","visibility","policyVersion","activeRevisionId","publicationToken","deletedAt","suspendedAt","createdAt","updatedAt"],"additionalProperties":false}},"connections":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"resource":{"type":"string","format":"uri"},"scopes":{"maxItems":7,"type":"array","items":{"type":"string","enum":["artifact:read","artifact:publish","artifact:manage","artifact:visibility","data:read","data:write","data:submit"]}},"clientId":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}]},"clientName":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}]},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"revokedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"lastUsedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","workspaceId","resource","scopes","clientId","clientName","createdAt","expiresAt","revokedAt","lastUsedAt"],"additionalProperties":false}},"activity":{"maxItems":6,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":180},"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string","maxLength":160},"action":{"type":"string","enum":["created","updated"]},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","artifactId","title","action","createdAt"],"additionalProperties":false}},"usage":{"anyOf":[{"type":"object","properties":{"usedBytes":{"type":"integer","minimum":0,"maximum":9007199254740991},"limitBytes":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["usedBytes","limitBytes"],"additionalProperties":false},{"type":"null"}]}},"required":["workspaceId","counts","recentPages","connections","activity","usage"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/overview.ts#WorkspaceOverview","x-schema-io":"output"},"Session":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"updatedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"current":{"type":"boolean"}},"required":["id","createdAt","updatedAt","expiresAt","current"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/account.ts#SessionDescriptor","x-schema-io":"output"},"SessionPage":{"type":"object","properties":{"items":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":128},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"updatedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"current":{"type":"boolean"}},"required":["id","createdAt","updatedAt","expiresAt","current"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/account.ts#SessionPage","x-schema-io":"output"},"AccountProfile":{"type":"object","properties":{"userId":{"type":"string","minLength":1,"maxLength":128},"name":{"type":"string"},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"memberships":{"type":"array","items":{"type":"object","properties":{"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"userId":{"type":"string","minLength":1,"maxLength":128},"role":{"type":"string","enum":["owner","admin","editor","viewer"]}},"required":["workspaceId","userId","role"],"additionalProperties":false}},"defaultWorkspaceId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"avatarUrl":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}]},"hasProviderAvatar":{"type":"boolean"},"avatarMode":{"type":"string","enum":["provider","custom","none"]},"profileVersion":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["userId","name","email","memberships","defaultWorkspaceId","avatarUrl","hasProviderAvatar","avatarMode","profileVersion"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/account.ts#AccountProfile","x-schema-io":"output"},"UpdateAccountProfile":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"defaultWorkspaceId":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"avatar":{"type":"string","enum":["provider","none"]}},"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/account.ts#UpdateAccountProfile","x-schema-io":"input"},"WorkspaceMember":{"type":"object","properties":{"userId":{"type":"string","minLength":1,"maxLength":128},"name":{"type":"string"},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"avatarUrl":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"role":{"type":"string","enum":["owner","admin","editor","viewer"]},"joinedAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["userId","name","email","avatarUrl","role","joinedAt"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/account.ts#WorkspaceMember","x-schema-io":"output"},"WorkspaceMemberPage":{"type":"object","properties":{"items":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"userId":{"type":"string","minLength":1,"maxLength":128},"name":{"type":"string"},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"avatarUrl":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"role":{"type":"string","enum":["owner","admin","editor","viewer"]},"joinedAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["userId","name","email","avatarUrl","role","joinedAt"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}]}},"required":["items","nextCursor"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/account.ts#WorkspaceMemberPage","x-schema-io":"output"},"InvitationContinuation":{"type":"object","properties":{"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"continuationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"callbackURL":{"type":"string","maxLength":128}},"required":["expiresAt","continuationId","callbackURL"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/account.ts#InvitationContinuation","x-schema-io":"output"},"InvitationContinuationStatus":{"type":"object","properties":{"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expiresAt"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/account.ts#InvitationContinuationStatus","x-schema-io":"output"},"InvitationContinuationInput":{"type":"object","properties":{"token":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["token"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/account.ts#InvitationContinuationInput","x-schema-io":"input"},"AcceptInvitationInput":{"anyOf":[{"type":"object","properties":{"token":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["token"],"additionalProperties":false},{"type":"object","properties":{"continuationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["continuationId"],"additionalProperties":false}],"x-runtime-schema":"packages/contracts/src/account.ts#AcceptInvitationInput","x-schema-io":"input"},"RegisterMcpClient":{"type":"object","properties":{"auditWorkspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[^\\p{Cc}\\p{Cf}]+$"},"redirectUris":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","minLength":1,"maxLength":2048}},"scopes":{"minItems":1,"maxItems":8,"type":"array","items":{"type":"string","enum":["artifact:read","artifact:publish","artifact:manage","artifact:visibility","data:read","data:write","data:submit","offline_access"]}}},"required":["auditWorkspaceId","name","redirectUris","scopes"],"additionalProperties":false,"x-runtime-schema":"packages/domain/integrations/client-registration.ts#RegisterMcpClient","x-schema-io":"input"},"DisableMcpClient":{"type":"object","properties":{"auditWorkspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"clientId":{"type":"string","minLength":1,"maxLength":128},"reason":{"type":"string","minLength":1,"maxLength":500,"pattern":"^[^\\p{Cc}\\p{Cf}]+$"}},"required":["auditWorkspaceId","clientId","reason"],"additionalProperties":false,"x-runtime-schema":"packages/domain/integrations/client-registration.ts#DisableMcpClient","x-schema-io":"input"},"InitializeMcpIntrospectionClient":{"type":"object","properties":{"auditWorkspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["auditWorkspaceId"],"additionalProperties":false,"x-runtime-schema":"packages/domain/integrations/client-registration.ts#InitializeMcpIntrospectionClient","x-schema-io":"input"},"RegisteredMcpClient":{"type":"object","properties":{"operationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"clientId":{"type":"string","minLength":1,"maxLength":128},"name":{"type":"string","maxLength":160},"redirectUris":{"maxItems":3,"type":"array","items":{"type":"string","maxLength":2048}},"scopes":{"maxItems":8,"type":"array","items":{"type":"string","enum":["artifact:read","artifact:publish","artifact:manage","artifact:visibility","data:read","data:write","data:submit","offline_access"]}},"resource":{"type":"string","format":"uri"},"applicationType":{"type":"string","enum":["web","native"]},"tokenEndpointAuthMethod":{"type":"string","const":"none"},"grantTypes":{"type":"array","prefixItems":[{"type":"string","const":"authorization_code"},{"type":"string","const":"refresh_token"}],"items":false,"minItems":2,"maxItems":2},"responseTypes":{"type":"array","prefixItems":[{"type":"string","const":"code"}],"items":false,"minItems":1,"maxItems":1},"requirePKCE":{"type":"boolean","const":true},"codeChallengeMethod":{"type":"string","const":"S256"},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","const":"registered"}},"required":["operationId","clientId","name","redirectUris","scopes","resource","applicationType","tokenEndpointAuthMethod","grantTypes","responseTypes","requirePKCE","codeChallengeMethod","createdAt","status"],"additionalProperties":false,"x-runtime-schema":"packages/domain/integrations/client-registration.ts#RegisteredMcpClient","x-schema-io":"output"},"DisabledMcpClient":{"type":"object","properties":{"operationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"clientId":{"type":"string","minLength":1,"maxLength":128},"resource":{"type":"string","format":"uri"},"disabledAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","const":"disabled"}},"required":["operationId","clientId","resource","disabledAt","status"],"additionalProperties":false,"x-runtime-schema":"packages/domain/integrations/client-registration.ts#DisabledMcpClient","x-schema-io":"output"},"InitializedMcpIntrospectionClient":{"type":"object","properties":{"operationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"clientId":{"type":"string","minLength":1,"maxLength":128},"resource":{"type":"string","format":"uri"},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","const":"initialized"}},"required":["operationId","clientId","resource","createdAt","status"],"additionalProperties":false,"x-runtime-schema":"packages/domain/integrations/client-registration.ts#InitializedMcpIntrospectionClient","x-schema-io":"output"},"HttpPrepareUpload":{"type":"object","properties":{"artifactId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"format":{"type":"string","enum":["html","zip","folder"]},"declaredBytes":{"type":"integer","exclusiveMinimum":0,"maximum":16777216},"expandedBytes":{"type":"integer","exclusiveMinimum":0,"maximum":33554432},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"routing":{"type":"object","properties":{"mode":{"type":"string","enum":["static","spa"]},"entry":{"default":"index.html","type":"string"},"spaRoutes":{"default":[],"maxItems":128,"type":"array","items":{"type":"string","maxLength":240}},"seo":{"maxItems":256,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":2162,"format":"starts_with","pattern":"^\\/.*"},"title":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":320},"language":{"type":"string","maxLength":64},"noindex":{"type":"boolean"}},"required":["path"],"additionalProperties":false}}},"required":["mode"],"additionalProperties":false},"files":{"minItems":1,"maxItems":256,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":240},"size":{"type":"integer","minimum":0,"maximum":4194304},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["path","size","sha256"],"additionalProperties":false}}},"required":["format","declaredBytes","expandedBytes","sha256","routing"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#PrepareUpload","x-schema-io":"input","x-http-projection":{"from":"PrepareUpload","omitted":[],"optional":["artifactId"]},"description":"artifactId is supplied by the route; if present in JSON it must match. Streaming/extraction, safe paths, entry mapping, hashes, expanded limits, and cross-field consistency are enforced again by the service."},"HttpPublishInput":{"type":"object","properties":{"revisionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedPolicyVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expectedVisibility":{"type":"string","enum":["private","team","public"]}},"required":["revisionId","expectedPolicyVersion","expectedVisibility"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/index.ts#PublishInput","x-schema-io":"input","x-http-projection":{"from":"PublishInput","omitted":["expectedPublicationToken"],"optional":[]},"description":"Expected publication token is supplied only by required quoted If-Match. The service rechecks ready revision, policy version, visibility, and authorization at the atomic publication switch."},"HttpRecordMutation":{"type":"object","properties":{"value":{},"schemaVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["value","schemaVersion"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/data.ts#DataMutationInput","x-schema-io":"input","x-http-projection":{"from":"DataMutationInput","omitted":["key","expectedEtag"],"optional":[]}},"HttpMigrationDraft":{"type":"object","properties":{"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"targetVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"targetPolicy":{"type":"object","properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,47}$"},"schemaVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"scope":{"type":"string","enum":["viewer","shared","submission"]},"permissionsVersion":{"type":"number","const":2},"permissions":{"type":"object","properties":{"read":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"add":{"type":"string","enum":["none","owner","members","authenticated","anyone"]},"edit":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]},"delete":{"type":"string","enum":["none","owner","members","authenticated","anyone","creator"]}},"required":["read","add","edit","delete"],"additionalProperties":false},"maxRecords":{"default":1000,"type":"integer","exclusiveMinimum":0,"maximum":1000},"maxBytes":{"default":16384,"type":"integer","exclusiveMinimum":0,"maximum":16384},"schema":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","enum":["string","number","boolean","object","array","null"]}}},"required":["name","schemaVersion","scope","permissionsVersion","permissions"],"additionalProperties":false},"steps":{"minItems":1,"maxItems":16,"type":"array","items":{"oneOf":[{"type":"object","properties":{"operation":{"type":"string","const":"add-default"},"field":{"type":"string","pattern":"^[a-zA-Z_][a-zA-Z0-9_]{0,63}$"},"value":{}},"required":["operation","field","value"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","const":"rename-field"},"from":{"type":"string","pattern":"^[a-zA-Z_][a-zA-Z0-9_]{0,63}$"},"to":{"type":"string","pattern":"^[a-zA-Z_][a-zA-Z0-9_]{0,63}$"}},"required":["operation","from","to"],"additionalProperties":false}]}}},"required":["expectedVersion","targetVersion","targetPolicy","steps"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/data.ts#CollectionMigrationPlan","x-schema-io":"input","x-http-projection":{"from":"CollectionMigrationPlan","omitted":["expectedPolicyDigest","digest"],"optional":[]}},"HttpDisableMcpClient":{"type":"object","properties":{"auditWorkspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"reason":{"type":"string","minLength":1,"maxLength":500,"pattern":"^[^\\p{Cc}\\p{Cf}]+$"}},"required":["auditWorkspaceId","reason"],"additionalProperties":false,"x-runtime-schema":"packages/domain/integrations/client-registration.ts#DisableMcpClient","x-schema-io":"input","x-http-projection":{"from":"DisableMcpClient","omitted":["clientId"],"optional":[]}},"ExpectedUpdatedAt":{"type":"object","properties":{"expectedUpdatedAt":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["expectedUpdatedAt"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/artifacts.ts#update/remove/restore"},"SignInProviders":{"type":"object","properties":{"email":{"type":"boolean"},"google":{"type":"boolean"},"github":{"type":"boolean"}},"required":["email","google","github"],"additionalProperties":false,"x-adapter-source":"packages/domain/identity/auth.ts#signInProviders","description":"Configuration availability only. Never returns credentials, provider tokens, or user identifiers."},"Environment":{"type":"object","properties":{"environment":{"type":"string"},"appOrigin":{"type":"string","format":"uri"},"contentOrigin":{"type":"string","format":"uri"},"mcpResource":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"candidate":{"type":"string"}},"required":["environment","appOrigin","contentOrigin","mcpResource","candidate"],"additionalProperties":false,"x-adapter-source":"apps/web/src/routes/api.v1.$.ts; packages/domain/identity/workspaces.ts; packages/domain/identity/account.ts"},"Workspace":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/Id"},"slug":{"type":"string"},"name":{"type":"string"},"role":{"$ref":"#/components/schemas/Role"},"usedBytes":{"type":"integer","minimum":0},"reservedBytes":{"type":"integer","minimum":0},"byteLimit":{"type":"integer","minimum":0}},"required":["id","slug","name","role","usedBytes","reservedBytes","byteLimit"],"additionalProperties":false,"x-adapter-source":"apps/web/src/routes/api.v1.$.ts; packages/domain/identity/workspaces.ts; packages/domain/identity/account.ts"},"Invitation":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/Id"},"email":{"type":"string","format":"email"},"role":{"enum":["admin","editor","viewer"]},"expiresAt":{"type":"integer","minimum":0},"status":{"const":"sent"}},"required":["id","email","role","expiresAt","status"],"additionalProperties":false,"x-adapter-source":"apps/web/src/routes/api.v1.$.ts; packages/domain/identity/workspaces.ts; packages/domain/identity/account.ts"},"InvitationStatus":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/Id"},"email":{"type":"string","format":"email"},"role":{"enum":["admin","editor","viewer"]},"expiresAt":{"type":"integer","minimum":0},"acceptedAt":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]}},"required":["id","email","role","expiresAt","acceptedAt","revokedAt"],"additionalProperties":false,"x-adapter-source":"apps/web/src/routes/api.v1.$.ts; packages/domain/identity/workspaces.ts; packages/domain/identity/account.ts"},"InvitationAcceptance":{"type":"object","properties":{"workspaceId":{"$ref":"#/components/schemas/Id"}},"required":["workspaceId"],"additionalProperties":false,"x-adapter-source":"apps/web/src/routes/api.v1.$.ts; packages/domain/identity/workspaces.ts; packages/domain/identity/account.ts"},"InvitationTokenInput":{"$ref":"#/components/schemas/AcceptInvitationInput"},"PolicyReceipt":{"type":"object","properties":{"artifactId":{"$ref":"#/components/schemas/Id"},"policyVersion":{"type":"integer","minimum":1},"visibility":{"$ref":"#/components/schemas/Visibility"}},"required":["artifactId","policyVersion","visibility"],"additionalProperties":false,"x-adapter-source":"packages/domain/policy/sharing.ts"},"ArtifactGrant":{"type":"object","properties":{"userId":{"type":"string"},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/Capability"},"maxItems":7},"name":{"type":"string"},"email":{"type":"string","maxLength":254,"format":"email"},"isMember":{"type":"boolean"}},"required":["userId","capabilities"],"additionalProperties":false,"x-adapter-source":"packages/domain/policy/sharing.ts#listArtifactGrants","description":"Only the page owner receives identifying metadata for current workspace members or recipients who accepted an invitation on this page. Unknown outsider grants do not expose account names/emails. Per-person data capabilities are retained for compatibility; collection rules determine runtime access."},"GrantInput":{"type":"object","properties":{"userId":{"type":"string","maxLength":128,"pattern":"^[A-Za-z0-9_-]{1,128}$"},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/Capability"},"maxItems":7,"uniqueItems":true},"expectedPolicyVersion":{"type":"integer","minimum":1}},"required":["userId","capabilities","expectedPolicyVersion"],"additionalProperties":false,"x-adapter-source":"packages/domain/policy/sharing.ts#GrantInput","description":"Capabilities must also pass current actor delegation rules."},"GrantRevokeInput":{"type":"object","properties":{"expectedPolicyVersion":{"type":"integer","minimum":1}},"required":["expectedPolicyVersion"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/artifacts.ts"},"PreviewInput":{"type":"object","properties":{"revisionId":{"$ref":"#/components/schemas/Id"}},"required":["revisionId"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/artifacts.ts"},"RevisionSummary":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/Id"},"state":{"type":"string"},"bytes":{"type":"integer","minimum":0},"createdAt":{"type":"integer","minimum":0},"availability":{"enum":["available","retiring","retired"]}},"required":["id","state","bytes","createdAt"],"additionalProperties":false,"x-adapter-source":"packages/domain/publishing/commands.ts#revisions"},"RuntimeOperation":{"type":"object","properties":{"operation":{"type":"string","maxLength":48},"payload":{}},"required":["operation"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/artifacts.ts","description":"Allowlisted operation payload is validated by RenderingService. Mutation operations require Idempotency-Key. No caller-selected artifact, viewer, or arbitrary URL is authorized."},"RuntimeOperationResult":{"description":"Operation-specific JSON result for route/status/data commands; current authorization and the pinned render session bind every command. An empty schema here describes an intentionally variable protocol result, not a permissive runtime validator.","x-adapter-source":"packages/domain/rendering/index.ts#operation"},"CollectionAccess":{"type":"object","properties":{"read":{"type":"string","enum":["allowed","denied","creator"]},"add":{"type":"string","enum":["allowed","denied","creator"]},"edit":{"type":"string","enum":["allowed","denied","creator"]},"delete":{"type":"string","enum":["allowed","denied","creator"]},"migrate":{"type":"boolean"},"migrationRead":{"type":"boolean"},"locked":{"type":"boolean"}},"required":["read","add","edit","delete","migrate","migrationRead","locked"],"additionalProperties":false,"x-runtime-schema":"packages/contracts/src/authoring.ts#CollectionAccessHints","x-schema-io":"output","x-adapter-source":"packages/domain/data/access.ts#CollectionAccess"},"CollectionExport":{"type":"object","properties":{"artifactId":{"$ref":"#/components/schemas/Id"},"collection":{"type":"string"},"schemaVersion":{"type":"integer","minimum":1},"items":{"type":"array","items":{"$ref":"#/components/schemas/DataRecord"},"maxItems":50},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/Attachment"},"maxItems":200},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["artifactId","collection","schemaVersion","items","attachments","nextCursor"],"additionalProperties":false,"x-adapter-source":"packages/domain/data/index.ts#exportData"},"MigrationStatus":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/Id"},"collection":{"type":"string"},"digest":{"type":"string","maxLength":64,"pattern":"^[a-f0-9]{64}$"},"state":{"type":"string"},"fromVersion":{"type":"integer","minimum":1},"toVersion":{"type":"integer","minimum":1},"processed":{"type":"integer","minimum":0},"snapshotReady":{"type":"boolean"},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","collection","digest","state","fromVersion","toVersion","processed","snapshotReady","errorCode"],"additionalProperties":false,"x-adapter-source":"packages/domain/data/migrations.ts#MigrationStatus"},"MigrationApproval":{"type":"object","properties":{"digest":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["digest"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/data.ts"},"MigrationAdvance":{"type":"object","properties":{"digest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"expectedProcessed":{"type":"integer","minimum":0,"maximum":2000}},"required":["digest","expectedProcessed"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/data.ts"},"SubmissionReceipt":{"type":"object","properties":{"receipt":{"$ref":"#/components/schemas/RecordKey"}},"required":["receipt"],"additionalProperties":false,"x-adapter-source":"packages/domain/data/index.ts#submit"},"RecordDeletion":{"type":"object","properties":{"deleted":{"const":true},"key":{"$ref":"#/components/schemas/RecordKey"}},"required":["deleted","key"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/data.ts"},"RetentionHint":{"type":"object","properties":{"artifactId":{"$ref":"#/components/schemas/Id"},"revisionId":{"$ref":"#/components/schemas/Id"},"canRequest":{"type":"boolean"},"eligibleAt":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"reason":{"enum":["available","retention-unconfigured","retention-pending","active-publication","referenced","retiring","retired","unavailable"]}},"required":["artifactId","revisionId","canRequest","eligibleAt","reason"],"additionalProperties":false,"x-adapter-source":"packages/domain/artifacts/retention.ts#hints"},"RetentionInput":{"type":"object","properties":{"confirm":{"const":true},"expectedPolicyVersion":{"type":"integer","minimum":1}},"required":["confirm","expectedPolicyVersion"],"additionalProperties":false,"x-adapter-source":"packages/domain/artifacts/retention.ts#request"},"RetentionReceipt":{"type":"object","properties":{"artifactId":{"$ref":"#/components/schemas/Id"},"revisionId":{"$ref":"#/components/schemas/Id"},"status":{"const":"retirement-requested"},"eligibleAt":{"type":"integer","minimum":0}},"required":["artifactId","revisionId","status","eligibleAt"],"additionalProperties":false,"x-adapter-source":"packages/domain/artifacts/retention.ts#request"},"WorkspaceUsage":{"type":"object","properties":{"byteLimit":{"type":"integer","minimum":0},"fileAndAttachmentBytes":{"type":"integer","minimum":0},"reservedBytes":{"type":"integer","minimum":0},"recordBytes":{"type":"integer","minimum":0},"recordCount":{"type":"integer","minimum":0},"exportReservedBytes":{"type":"integer","minimum":0},"exportBytes":{"type":"integer","minimum":0},"dataRetryCount":{"type":"integer","minimum":0},"controlRetryCount":{"type":"integer","minimum":0},"securityRetryCount":{"type":"integer","minimum":0}},"required":["byteLimit","fileAndAttachmentBytes","reservedBytes","recordBytes","recordCount","exportReservedBytes","exportBytes","dataRetryCount","controlRetryCount","securityRetryCount"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/operations.ts; packages/domain/operations/admin.ts"},"AbuseReportInput":{"type":"object","properties":{"category":{"enum":["phishing","malware","harassment","other"]},"details":{"type":"string","maxLength":400,"default":""}},"required":["category"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/operations.ts; packages/domain/operations/admin.ts"},"AbuseReportReceipt":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/Id"},"status":{"const":"received"}},"required":["id","status"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/operations.ts; packages/domain/operations/admin.ts"},"OperationReceipt":{"type":"object","properties":{"operationId":{"$ref":"#/components/schemas/Id"},"action":{"type":"string"},"createdAt":{"type":"integer","minimum":0},"status":{"const":"completed"}},"required":["operationId","action","createdAt","status"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/operations.ts; packages/domain/operations/admin.ts","description":"The privileged command completed; background work may still be pending."},"OperatorAccess":{"type":"object","properties":{"userId":{"type":"string","maxLength":128,"minLength":1},"expiresAt":{"type":"integer","minimum":0}},"required":["userId","expiresAt"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/operations.ts; packages/domain/operations/admin.ts"},"OperatorMfaStatus":{"type":"object","properties":{"userId":{"type":"string","maxLength":128,"minLength":1},"enabled":{"type":"boolean"},"pendingEnrollment":{"type":"boolean"},"proofExpiresAt":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"proofMethod":{"anyOf":[{"enum":["totp","backup-code"]},{"type":"null"}]}},"required":["userId","enabled","pendingEnrollment","proofExpiresAt","proofMethod"],"additionalProperties":false,"x-adapter-source":"packages/domain/identity/operator-mfa-api.ts; packages/domain/identity/operator-mfa.ts; packages/domain/identity/operator-mfa-state.ts"},"OperatorMfaEnrollment":{"type":"object","properties":{"method":{"const":"totp"},"totpURI":{"type":"string","x-sensitive":true},"backupCodes":{"type":"array","items":{"type":"string"},"x-sensitive":true}},"required":["method","totpURI","backupCodes"],"additionalProperties":false,"x-adapter-source":"packages/domain/identity/operator-mfa-api.ts; packages/domain/identity/operator-mfa.ts; packages/domain/identity/operator-mfa-state.ts"},"OperatorMfaKey":{"type":"object","properties":{"totpURI":{"type":"string","x-sensitive":true}},"required":["totpURI"],"additionalProperties":false,"x-adapter-source":"packages/domain/identity/operator-mfa-api.ts; packages/domain/identity/operator-mfa.ts; packages/domain/identity/operator-mfa-state.ts"},"OperatorMfaBackupCodes":{"type":"object","properties":{"backupCodes":{"type":"array","items":{"type":"string"},"x-sensitive":true}},"required":["backupCodes"],"additionalProperties":false,"x-adapter-source":"packages/domain/identity/operator-mfa-api.ts; packages/domain/identity/operator-mfa.ts; packages/domain/identity/operator-mfa-state.ts"},"OperatorMfaCode":{"type":"object","properties":{"code":{"type":"string","maxLength":6,"minLength":6,"pattern":"^[0-9]{6}$"}},"required":["code"],"additionalProperties":false,"x-adapter-source":"packages/domain/identity/operator-mfa-api.ts; packages/domain/identity/operator-mfa.ts; packages/domain/identity/operator-mfa-state.ts"},"OperationReason":{"type":"object","properties":{"reason":{"type":"string","maxLength":500,"minLength":1}},"required":["reason"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/operations.ts; packages/domain/operations/admin.ts"},"ReportReviewInput":{"type":"object","properties":{"reason":{"type":"string","maxLength":500,"minLength":1},"decision":{"enum":["dismiss","suspend"]}},"required":["reason","decision"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/operations.ts; packages/domain/operations/admin.ts"},"SuspensionInput":{"type":"object","properties":{"reason":{"type":"string","maxLength":500,"minLength":1},"suspended":{"type":"boolean"}},"required":["reason","suspended"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/operations.ts; packages/domain/operations/admin.ts"},"OperationJob":{"type":"object","properties":{"id":{"type":"string","maxLength":180},"kind":{"type":"string"},"artifactId":{"anyOf":[{"$ref":"#/components/schemas/Id"},{"type":"null"}]},"state":{"enum":["pending","running","done","dead"]},"attempts":{"type":"integer","minimum":0},"createdAt":{"type":"integer","minimum":0},"availableAt":{"type":"integer","minimum":0},"heartbeatAt":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"finishedAt":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","kind","artifactId","state","attempts","createdAt","availableAt","heartbeatAt","finishedAt","errorCode"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/operations.ts; packages/domain/operations/admin.ts"},"OperationReport":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/Id"},"artifactId":{"$ref":"#/components/schemas/Id"},"reason":{"type":"string"},"createdAt":{"type":"integer","minimum":0},"resolvedAt":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"reviewedBy":{"anyOf":[{"type":"string"},{"type":"null"}]},"reviewAction":{"anyOf":[{"type":"string"},{"type":"null"}]},"reviewReason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","artifactId","reason","createdAt","resolvedAt","reviewedBy","reviewAction","reviewReason"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/operations.ts; packages/domain/operations/admin.ts"},"OperationAudit":{"type":"object","properties":{"id":{"type":"string"},"artifactId":{"anyOf":[{"$ref":"#/components/schemas/Id"},{"type":"null"}]},"actorId":{"anyOf":[{"type":"string"},{"type":"null"}]},"action":{"type":"string"},"requestId":{"type":"string"},"createdAt":{"type":"integer","minimum":0}},"required":["id","artifactId","actorId","action","requestId","createdAt"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/operations.ts; packages/domain/operations/admin.ts"},"OAuthSignedQuery":{"type":"object","properties":{"signedQuery":{"type":"string","maxLength":8192}},"required":["signedQuery"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/oauth.ts; packages/domain/identity/oauth-flow.ts"},"OAuthDeny":{"type":"object","properties":{"signedQuery":{"type":"string","maxLength":8192},"contextId":{"$ref":"#/components/schemas/Id"}},"required":["signedQuery","contextId"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/oauth.ts; packages/domain/identity/oauth-flow.ts"},"OAuthContinueInput":{"type":"object","properties":{"requestId":{"$ref":"#/components/schemas/Id"}},"required":["requestId"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/oauth.ts; packages/domain/identity/oauth-flow.ts"},"OAuthLogin":{"type":"object","properties":{"requestId":{"$ref":"#/components/schemas/Id"},"callbackURL":{"type":"string"},"expiresAt":{"type":"integer","minimum":0},"clientId":{"type":"string"},"clientName":{"type":"string"},"callbackOrigin":{"type":"string"}},"required":["requestId","callbackURL","expiresAt","clientId","clientName","callbackOrigin"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/oauth.ts; packages/domain/identity/oauth-flow.ts"},"OAuthRedirect":{"type":"object","properties":{"redirectTo":{"type":"string"}},"required":["redirectTo"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/oauth.ts; packages/domain/identity/oauth-flow.ts"},"OAuthConsentContext":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/Id"},"clientName":{"type":"string"},"clientId":{"type":"string"},"redirectUri":{"type":"string"},"resource":{"type":"string"},"requestedScopes":{"type":"array","items":{"type":"string"},"maxItems":8},"expiresAt":{"type":"integer","minimum":0}},"required":["id","clientName","clientId","redirectUri","resource","requestedScopes","expiresAt"],"additionalProperties":false,"x-adapter-source":"packages/domain/http/oauth.ts; packages/domain/identity/oauth-flow.ts"},"HttpOAuthConfirm":{"type":"object","properties":{"contextId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspaceId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"scopes":{"minItems":1,"maxItems":8,"type":"array","items":{"type":"string","enum":["artifact:read","artifact:publish","artifact:manage","artifact:visibility","data:read","data:write","data:submit","offline_access"]}},"signedQuery":{"type":"string","maxLength":8192}},"required":["contextId","workspaceId","scopes","signedQuery"],"additionalProperties":false,"x-runtime-schema":"packages/domain/identity/oauth-flow.ts#ConfirmOAuthConsent","x-schema-io":"input","x-adapter-source":"packages/domain/http/oauth.ts; packages/domain/identity/oauth-flow.ts"},"OAuthProviderError":{"type":"object","properties":{"error":{"type":"string"},"error_description":{"type":"string"}},"required":["error"],"additionalProperties":true,"x-adapter-source":"packages/domain/http/oauth.ts; packages/domain/identity/oauth-flow.ts","description":"Maintained Better Auth provider may return its OAuth error envelope from consent, rather than ApiError."}}},"x-schema-source-policy":"x-runtime-schema components are generated directly from actual Zod validators, with io=input/output. x-http-projection removes fields supplied by route/header. x-adapter-source envelopes describe inline adapter checks or typed service results and do not add runtime validators. Unrepresentable Zod types fail generation; custom refinements and context-sensitive checks remain server-enforced.","x-provider-protocol":{"owner":"Better Auth OAuth Provider","paths":"/api/auth/* (including /api/auth/oauth2/*) and maintained discovery","documentation":"https://www.better-auth.com/docs/plugins/oauth-provider","mcp":"MCP Streamable HTTP and its opaque bearer-token/resource validation are a separate protocol surface; this document does not define bearer authentication for /api/v1."}}