{"openapi":"3.1.0","info":{"title":"SpaceMedia Reports API","version":"1.46.0","summary":"Guarded reports, identity, import, analytics, export, reconciliation, dispute, webhook, and payout-operations API.","description":"The SpaceMedia Reports API powers royalty reporting, import, analytics, export, reconciliation, dispute, and payout operations. This contract contains only implemented guarded routes. A route remains unavailable unless its deployment feature flag and tenant access policy are enabled.","license":{"name":"Proprietary","identifier":"LicenseRef-Proprietary"},"x-lifecycle-policy":{"stability":"stable","minimum_deprecation_days":180,"sunset_header_required":true,"replacement_operation_required":true}},"servers":[{"url":"https://reports.spacemedia.uk","description":"Production edge. Guarded routes are disabled until release approval."}],"tags":[{"name":"Identity","description":"Human identity, invitation, session, and logout operations."},{"name":"MFA","description":"Multi-factor enrollment, challenge, and recovery operations."},{"name":"OAuth","description":"Tenant-bound OAuth client-credential exchange."},{"name":"API session","description":"Authenticated machine-session inspection."},{"name":"API clients","description":"Tenant API-client lifecycle and token administration."},{"name":"Imports","description":"Guarded royalty report intake and import workflow operations."},{"name":"Published analytics","description":"Published tenant analytics and commercial-rate reads."},{"name":"Exports","description":"Human and machine export lifecycle and authenticated delivery."},{"name":"Mapping review","description":"Human source-profile mapping evidence and decision operations."},{"name":"Reconciliation","description":"Completed import and cross-domain reconciliation evidence."},{"name":"Catalog review","description":"Human catalog-match evidence and decision operations."},{"name":"Anomalies","description":"Human anomaly inventory and immutable investigation comments."},{"name":"Disputes","description":"Dispute evidence, workflow, communications, and accounting commands."},{"name":"Payout operations","description":"Payout exception and protected alert-route operations."},{"name":"Webhook ingress","description":"Partner-authenticated tenant webhook intake with ordered replay protection."}],"paths":{"/platform/v1/identity/login":{"post":{"operationId":"loginPlatformIdentity","tags":["Identity"],"summary":"Establish a tenant-scoped human session.","security":[],"parameters":[{"$ref":"#/components/parameters/CsrfToken"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/PlatformSessionOk"},"401":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/identity/invitations/accept":{"post":{"operationId":"acceptNewPlatformInvitation","tags":["Identity"],"summary":"Accept an invitation and create a new verified identity.","security":[],"parameters":[{"$ref":"#/components/parameters/CsrfToken"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptNewInvitationRequest"}}}},"responses":{"201":{"$ref":"#/components/responses/PlatformSessionCreated"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/identity/invitations/accept-existing":{"post":{"operationId":"acceptExistingPlatformInvitation","tags":["Identity"],"summary":"Accept an invitation as the current step-up-authenticated identity.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptExistingInvitationRequest"}}}},"responses":{"201":{"description":"Membership activated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationAcceptanceResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/identity/mfa/enroll":{"post":{"operationId":"startPlatformMfaEnrollment","tags":["MFA"],"summary":"Start initial TOTP enrollment and return the secret once.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartMfaEnrollmentRequest"}}}},"responses":{"201":{"description":"Pending TOTP enrollment.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaEnrollmentResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/identity/mfa/confirm":{"post":{"operationId":"confirmPlatformMfaEnrollment","tags":["MFA"],"summary":"Confirm initial TOTP enrollment and return recovery codes once.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyMfaRequest"}}}},"responses":{"200":{"description":"MFA enrollment confirmed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaConfirmationResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/identity/mfa/challenge":{"post":{"operationId":"challengePlatformMfa","tags":["MFA"],"summary":"Verify a TOTP challenge and elevate the current session.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyMfaRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/PlatformSessionOk"},"401":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/identity/mfa/recovery":{"post":{"operationId":"recoverPlatformMfa","tags":["MFA"],"summary":"Consume one recovery code without satisfying sensitive step-up.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecoverMfaRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/PlatformSessionOk"},"401":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/identity/mfa/replacement/enroll":{"post":{"operationId":"startPlatformMfaReplacement","tags":["MFA"],"summary":"Start TOTP factor replacement after fresh non-recovery step-up.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartMfaEnrollmentRequest"}}}},"responses":{"201":{"description":"Pending replacement factor. The active factor remains authoritative.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaEnrollmentResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/identity/mfa/replacement/confirm":{"post":{"operationId":"confirmPlatformMfaReplacement","tags":["MFA"],"summary":"Atomically replace the active TOTP factor after fresh non-recovery step-up.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyMfaRequest"}}}},"responses":{"200":{"description":"Active factor replaced and new recovery codes returned once.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaConfirmationResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/identity/session":{"get":{"operationId":"getPlatformIdentitySession","tags":["Identity"],"summary":"Return the current opaque identity and tenant session.","security":[{"platformSession":[]}],"responses":{"200":{"$ref":"#/components/responses/PlatformSessionOk"},"401":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/identity/sessions":{"get":{"operationId":"listPlatformIdentitySessions","tags":["Identity"],"summary":"List the current identity's bounded tenant session history.","security":[{"platformSession":[]}],"responses":{"200":{"description":"Current and recent privacy-safe session inventory.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentitySessionPageResponse"}}}},"401":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/identity/sessions/{session}/revoke":{"post":{"operationId":"revokePlatformIdentitySession","tags":["Identity"],"summary":"Revoke another owned session after fresh non-recovery step-up.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/IdentitySessionPath"},{"$ref":"#/components/parameters/CsrfToken"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevokeIdentitySessionRequest"}}}},"responses":{"200":{"description":"Session revoked or its prior revocation replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentitySessionRevocationResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/identity/logout":{"post":{"operationId":"logoutPlatformIdentity","tags":["Identity"],"summary":"Revoke the current platform session.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"}],"responses":{"204":{"description":"Session revoked. Response has no body.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}}},"401":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/oauth/token":{"post":{"operationId":"exchangePlatformClientCredential","tags":["OAuth"],"summary":"Exchange one tenant-bound client credential for a short-lived bearer token.","security":[{"basicClient":[]}],"parameters":[{"$ref":"#/components/parameters/TenantHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthTokenRequest"}}}},"responses":{"200":{"description":"Bearer token issued.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthTokenResponse"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/api/session":{"get":{"operationId":"getPlatformApiSession","tags":["API session"],"summary":"Verify bearer authentication, tenant binding, and the tenant:read scope.","security":[{"bearerToken":[]}],"parameters":[{"$ref":"#/components/parameters/TenantHeader"}],"responses":{"200":{"description":"Authenticated API session.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiSessionResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/imports":{"post":{"operationId":"createPlatformImport","tags":["Imports"],"summary":"Create one tenant-owned import and expected immutable source manifest.","security":[{"bearerToken":[]}],"parameters":[{"$ref":"#/components/parameters/TenantHeader"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateImportRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/ImportOk"},"201":{"$ref":"#/components/responses/ImportCreated"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/imports/{importRef}":{"parameters":[{"$ref":"#/components/parameters/ImportPath"}],"get":{"operationId":"getPlatformImport","tags":["Imports"],"summary":"Return opaque import workflow and bounded profiling evidence.","security":[{"bearerToken":[]}],"parameters":[{"$ref":"#/components/parameters/TenantHeader"}],"responses":{"200":{"$ref":"#/components/responses/ImportOk"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/imports/{importRef}/upload-sessions":{"parameters":[{"$ref":"#/components/parameters/ImportPath"}],"post":{"operationId":"createPlatformImportUploadSession","tags":["Imports"],"summary":"Issue one short-lived tenant-bound resumable upload authority.","security":[{"bearerToken":[]}],"parameters":[{"$ref":"#/components/parameters/TenantHeader"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"$ref":"#/components/responses/UploadSessionOk"},"201":{"$ref":"#/components/responses/UploadSessionCreated"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/imports/{importRef}/mapping-suggestions":{"parameters":[{"$ref":"#/components/parameters/ImportPath"}],"get":{"operationId":"getPlatformImportMappingSuggestions","tags":["Imports"],"summary":"Return bounded mapping suggestions without machine approval authority.","security":[{"bearerToken":[]}],"parameters":[{"$ref":"#/components/parameters/TenantHeader"}],"responses":{"200":{"$ref":"#/components/responses/ImportMappingSuggestionsOk"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/imports/{importRef}/profile":{"parameters":[{"$ref":"#/components/parameters/ImportPath"}],"post":{"operationId":"profilePlatformImport","tags":["Imports"],"summary":"Enqueue durable profiling from verified immutable source evidence.","security":[{"bearerToken":[]}],"parameters":[{"$ref":"#/components/parameters/TenantHeader"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileImportRequest"}}}},"responses":{"202":{"$ref":"#/components/responses/ImportProfileAccepted"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/imports/{importRef}/cancel":{"parameters":[{"$ref":"#/components/parameters/ImportPath"}],"post":{"operationId":"cancelPlatformImport","tags":["Imports"],"summary":"Cancel an eligible active import without deleting retained evidence.","security":[{"bearerToken":[]}],"parameters":[{"$ref":"#/components/parameters/TenantHeader"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelImportRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/ImportCommandOk"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/analytics/summary":{"get":{"operationId":"getPublishedAnalyticsSummary","tags":["Published analytics"],"summary":"Return exact totals from atomically published enterprise generations.","security":[{"bearerToken":[]}],"parameters":[{"$ref":"#/components/parameters/TenantHeader"},{"name":"currency","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CurrencyCode"}},{"name":"currency_basis","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CurrencyBasis"}},{"name":"import","in":"query","required":false,"schema":{"$ref":"#/components/schemas/Uuid"}},{"name":"period_start","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ReportMonth"}},{"name":"period_end","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ReportMonth"}}],"responses":{"200":{"$ref":"#/components/responses/PublishedAnalyticsSummaryOk"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/analytics/filter-options":{"get":{"operationId":"listPublishedAnalyticsFilterOptions","tags":["Published analytics"],"summary":"List privacy-protected filter options across published commercial dimensions.","security":[{"bearerToken":[]}],"parameters":[{"$ref":"#/components/parameters/TenantHeader"},{"name":"currency","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CurrencyCode"}},{"name":"currency_basis","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CurrencyBasis"}},{"name":"basis","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RateBasis"}},{"name":"import","in":"query","required":false,"schema":{"$ref":"#/components/schemas/Uuid"}},{"name":"taxonomy","in":"query","required":false,"schema":{"$ref":"#/components/schemas/Uuid"}},{"name":"period_start","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ReportMonth"}},{"name":"period_end","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ReportMonth"}}],"responses":{"200":{"$ref":"#/components/responses/PublishedAnalyticsFilterOptionsOk"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/analytics/readiness":{"get":{"operationId":"getPublishedAnalyticsReadiness","tags":["Published analytics"],"summary":"Return aggregate availability and freshness for published analytics generations.","security":[{"bearerToken":[]}],"parameters":[{"$ref":"#/components/parameters/TenantHeader"}],"responses":{"200":{"$ref":"#/components/responses/PublishedAnalyticsReadinessOk"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/analytics/rates":{"get":{"operationId":"listPublishedObservedRates","tags":["Published analytics"],"summary":"List privacy-thresholded generation-scoped observed CPM or per-unit rates.","security":[{"bearerToken":[]}],"parameters":[{"$ref":"#/components/parameters/TenantHeader"},{"name":"currency","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CurrencyCode"}},{"name":"currency_basis","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CurrencyBasis"}},{"name":"basis","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RateBasis"}},{"name":"dimension","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CommercialDimension"}},{"name":"import","in":"query","required":false,"schema":{"$ref":"#/components/schemas/Uuid"}},{"name":"taxonomy","in":"query","required":false,"schema":{"$ref":"#/components/schemas/Uuid"}},{"name":"state","in":"query","required":false,"schema":{"$ref":"#/components/schemas/CommercialValueState"}},{"name":"key","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"period_start","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ReportMonth"}},{"name":"period_end","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ReportMonth"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":2048}}],"responses":{"200":{"$ref":"#/components/responses/PublishedObservedRatePageOk"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/analytics/breakdown":{"get":{"operationId":"listPublishedAnalyticsBreakdown","tags":["Published analytics"],"summary":"Aggregate reviewed commercial dimensions across published generations.","security":[{"bearerToken":[]}],"parameters":[{"$ref":"#/components/parameters/TenantHeader"},{"name":"currency","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CurrencyCode"}},{"name":"currency_basis","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CurrencyBasis"}},{"name":"basis","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RateBasis"}},{"name":"dimension","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CommercialDimension"}},{"name":"import","in":"query","required":false,"schema":{"$ref":"#/components/schemas/Uuid"}},{"name":"taxonomy","in":"query","required":false,"schema":{"$ref":"#/components/schemas/Uuid"}},{"name":"state","in":"query","required":false,"schema":{"$ref":"#/components/schemas/CommercialValueState"}},{"name":"key","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":160}},{"name":"period_start","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ReportMonth"}},{"name":"period_end","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ReportMonth"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":2048}}],"responses":{"200":{"$ref":"#/components/responses/PublishedAnalyticsBreakdownPageOk"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/exports":{"get":{"operationId":"listPlatformExports","tags":["Exports"],"summary":"List a bounded page of safe export lifecycle states using exports:read authority.","security":[{"bearerToken":[]}],"x-required-scopes":["exports:read"],"parameters":[{"$ref":"#/components/parameters/TenantHeader"},{"name":"cursor","in":"query","required":false,"schema":{"$ref":"#/components/schemas/Uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"export_class","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ExportClass"}},{"name":"status","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ExportStatus"}},{"name":"format","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ExportFormat"}}],"responses":{"200":{"$ref":"#/components/responses/ExportPageOk"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"createPlatformExport","tags":["Exports"],"summary":"Queue one bounded external-tenant export using exports:write authority.","description":"Artifact delivery is deliberately outside this operation and contract.","security":[{"bearerToken":[]}],"x-required-scopes":["exports:write"],"parameters":[{"$ref":"#/components/parameters/TenantHeader"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateExportRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/ExportRequestAccepted"},"201":{"$ref":"#/components/responses/ExportRequestAccepted"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/exports/{export}":{"parameters":[{"$ref":"#/components/parameters/ExportPath"}],"get":{"operationId":"getPlatformExport","tags":["Exports"],"summary":"Poll safe export lifecycle state using exports:write authority.","security":[{"bearerToken":[]}],"x-required-scopes":["exports:write"],"parameters":[{"$ref":"#/components/parameters/TenantHeader"}],"responses":{"200":{"$ref":"#/components/responses/ExportOk"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/exports/{export}/download":{"parameters":[{"$ref":"#/components/parameters/ExportPath"}],"get":{"operationId":"downloadPlatformExport","tags":["Exports"],"summary":"Download one complete ready export using exports:read authority.","description":"Range and partial-content delivery are unsupported.","security":[{"bearerToken":[]}],"x-required-scopes":["exports:read"],"parameters":[{"$ref":"#/components/parameters/TenantHeader"}],"responses":{"200":{"$ref":"#/components/responses/ExportDownloadOk"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/exports/{export}/cancel":{"parameters":[{"$ref":"#/components/parameters/ExportPath"}],"post":{"operationId":"cancelPlatformExport","tags":["Exports"],"summary":"Cancel an export only while it remains queued using exports:write authority.","security":[{"bearerToken":[]}],"x-required-scopes":["exports:write"],"parameters":[{"$ref":"#/components/parameters/TenantHeader"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportCommandRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/ExportOk"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/exports/{export}/revoke":{"parameters":[{"$ref":"#/components/parameters/ExportPath"}],"post":{"operationId":"revokePlatformExport","tags":["Exports"],"summary":"Revoke a ready export using exports:write authority without delivering its artifact.","security":[{"bearerToken":[]}],"x-required-scopes":["exports:write"],"parameters":[{"$ref":"#/components/parameters/TenantHeader"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportCommandRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/ExportOk"},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/exports":{"get":{"operationId":"listPlatformExportsAsHuman","tags":["Exports"],"summary":"List a bounded page of safe export lifecycle states as an authorized external-tenant member.","security":[{"platformSession":[]}],"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"$ref":"#/components/schemas/Uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"export_class","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ExportClass"}},{"name":"status","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ExportStatus"}},{"name":"format","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ExportFormat"}}],"responses":{"200":{"$ref":"#/components/responses/ExportPageOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"createPlatformExportAsHuman","tags":["Exports"],"summary":"Queue one bounded export as a recently step-up-authenticated external-tenant member.","description":"Artifact delivery is deliberately outside this operation and contract.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateExportRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/ExportRequestAccepted"},"201":{"$ref":"#/components/responses/ExportRequestAccepted"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/exports/{export}":{"parameters":[{"$ref":"#/components/parameters/ExportPath"}],"get":{"operationId":"getPlatformExportAsHuman","tags":["Exports"],"summary":"Poll safe export lifecycle state as an authorized external-tenant member.","security":[{"platformSession":[]}],"responses":{"200":{"$ref":"#/components/responses/ExportOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/exports/{export}/download":{"parameters":[{"$ref":"#/components/parameters/ExportPath"}],"get":{"operationId":"downloadPlatformExportAsHuman","tags":["Exports"],"summary":"Download one complete ready export with recent non-recovery MFA step-up.","description":"Range and partial-content delivery are unsupported.","security":[{"platformSession":[]}],"responses":{"200":{"$ref":"#/components/responses/ExportDownloadOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/exports/{export}/cancel":{"parameters":[{"$ref":"#/components/parameters/ExportPath"}],"post":{"operationId":"cancelPlatformExportAsHuman","tags":["Exports"],"summary":"Cancel a queued export as a recently step-up-authenticated external-tenant member.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportCommandRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/ExportOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/exports/{export}/revoke":{"parameters":[{"$ref":"#/components/parameters/ExportPath"}],"post":{"operationId":"revokePlatformExportAsHuman","tags":["Exports"],"summary":"Revoke a ready export as a recently step-up-authenticated external-tenant member.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportCommandRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/ExportOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/imports":{"get":{"operationId":"listPlatformMappingReviews","tags":["Mapping review"],"summary":"List bounded tenant imports awaiting human mapping review.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"$ref":"#/components/responses/MappingReviewPageOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/imports/{importRef}":{"parameters":[{"$ref":"#/components/parameters/ImportPath"}],"get":{"operationId":"getPlatformMappingReview","tags":["Mapping review"],"summary":"Return profiled source evidence for one human mapping review.","security":[{"platformSession":[]}],"responses":{"200":{"$ref":"#/components/responses/ImportOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/imports/{importRef}/mapping/preview":{"parameters":[{"$ref":"#/components/parameters/ImportPath"}],"post":{"operationId":"previewPlatformMapping","tags":["Mapping review"],"summary":"Validate and preview one declarative mapping without saving it.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MappingDefinitionRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/MappingPreviewOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/imports/{importRef}/mapping/approve":{"parameters":[{"$ref":"#/components/parameters/ImportPath"}],"post":{"operationId":"approvePlatformMapping","tags":["Mapping review"],"summary":"Approve and remember one reviewed mapping under recent MFA when maker-checker is disabled.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MappingDefinitionRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/MappingApprovalOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/imports/{importRef}/mapping/proposal":{"parameters":[{"$ref":"#/components/parameters/ImportPath"}],"get":{"operationId":"getPlatformMappingProposal","tags":["Mapping review"],"summary":"Return the tenant maker-checker policy and latest immutable proposal.","security":[{"platformSession":[]}],"responses":{"200":{"$ref":"#/components/responses/MappingProposalPolicyOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/imports/{importRef}/mapping/proposals":{"parameters":[{"$ref":"#/components/parameters/ImportPath"}],"post":{"operationId":"proposePlatformMapping","tags":["Mapping review"],"summary":"Submit exact mapping-preview evidence for a distinct checker under recent MFA.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MappingDefinitionRequest"}}}},"responses":{"201":{"$ref":"#/components/responses/MappingProposalCreated"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/mapping-proposals/{proposalRef}/approve":{"parameters":[{"$ref":"#/components/parameters/MappingProposalPath"}],"post":{"operationId":"approvePlatformMappingProposal","tags":["Mapping review"],"summary":"Approve an exact proposal as a distinct checker under recent MFA.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"$ref":"#/components/responses/MappingProposalDecisionOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/mapping-proposals/{proposalRef}/reject":{"parameters":[{"$ref":"#/components/parameters/MappingProposalPath"}],"post":{"operationId":"rejectPlatformMappingProposal","tags":["Mapping review"],"summary":"Reject an exact proposal as a distinct checker under recent MFA.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RejectMappingProposalRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/MappingProposalDecisionOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/reconciliations":{"get":{"operationId":"listPlatformReconciliations","tags":["Reconciliation"],"summary":"List bounded completed canonical reconciliations with validation evidence.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"$ref":"#/components/responses/ReconciliationPageOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/reconciliations/{importRef}":{"parameters":[{"$ref":"#/components/parameters/ImportPath"}],"get":{"operationId":"getPlatformReconciliation","tags":["Reconciliation"],"summary":"Return exact complete-file canonical and validation evidence for one import.","security":[{"platformSession":[]}],"responses":{"200":{"$ref":"#/components/responses/ReconciliationDetailOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/api-clients":{"get":{"operationId":"listPlatformApiClients","tags":["API clients"],"summary":"List opaque API-client metadata for the current external tenant.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"Bounded client page.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiClientPage"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"createPlatformApiClient","tags":["API clients"],"summary":"Issue one API client and return its plaintext secret once.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiClientRequest"}}}},"responses":{"201":{"$ref":"#/components/responses/ManagedApiClientCreated"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/api-clients/{client}":{"parameters":[{"$ref":"#/components/parameters/ClientPath"}],"patch":{"operationId":"updatePlatformApiClient","tags":["API clients"],"summary":"Change a client name and expiry authority.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateApiClientRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/ManagedApiClientOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"delete":{"operationId":"revokePlatformApiClient","tags":["API clients"],"summary":"Terminally revoke one client and all active bearer tokens.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"$ref":"#/components/responses/ManagedApiClientOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/api-clients/{client}/tokens":{"parameters":[{"$ref":"#/components/parameters/ClientPath"}],"get":{"operationId":"listPlatformApiClientTokens","tags":["API clients"],"summary":"List opaque bearer-token metadata for one client.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"Bounded token page.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiTokenPage"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/api-clients/{client}/tokens/{token}":{"parameters":[{"$ref":"#/components/parameters/ClientPath"},{"$ref":"#/components/parameters/TokenPath"}],"delete":{"operationId":"revokePlatformApiClientToken","tags":["API clients"],"summary":"Revoke one client-bound bearer token.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"$ref":"#/components/responses/ManagedApiClientOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/api-clients/{client}/scopes":{"parameters":[{"$ref":"#/components/parameters/ClientPath"}],"put":{"operationId":"replacePlatformApiClientScopes","tags":["API clients"],"summary":"Replace client scopes and revoke existing bearer tokens.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceApiClientScopesRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/ManagedApiClientOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/api-clients/{client}/rotate":{"parameters":[{"$ref":"#/components/parameters/ClientPath"}],"post":{"operationId":"rotatePlatformApiClient","tags":["API clients"],"summary":"Rotate a client secret with a bounded overlap window.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotateApiClientRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/ManagedApiClientOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/api-clients/{client}/disable":{"parameters":[{"$ref":"#/components/parameters/ClientPath"}],"post":{"operationId":"disablePlatformApiClient","tags":["API clients"],"summary":"Disable a client and revoke existing bearer tokens.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"$ref":"#/components/responses/ManagedApiClientOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/api-clients/{client}/enable":{"parameters":[{"$ref":"#/components/parameters/ClientPath"}],"post":{"operationId":"enablePlatformApiClient","tags":["API clients"],"summary":"Re-enable a non-expired disabled client.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"$ref":"#/components/responses/ManagedApiClientOk"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/catalog/entities":{"get":{"operationId":"listPlatformCatalogEntities","tags":["Catalog review"],"summary":"List tenant-scoped catalog entities with their latest verified snapshots.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"name":"entity_type","in":"query","required":false,"schema":{"type":"string","enum":["recording","release","work","party"]}}],"responses":{"200":{"description":"Bounded catalog entity page.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogEntityPage"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/catalog/entities/{entity}":{"get":{"operationId":"getPlatformCatalogEntity","tags":["Catalog review"],"summary":"Return one tenant-owned catalog entity with its latest verified snapshot and identifiers.","security":[{"platformSession":[]}],"parameters":[{"name":"entity","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Uuid"}}],"responses":{"200":{"description":"Verified catalog entity detail.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogEntityDetailResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/catalog/matches":{"get":{"operationId":"listPlatformCatalogMatches","tags":["Catalog review"],"summary":"List tenant-scoped catalog match cases for authorized human review.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/CatalogReviewState"}],"responses":{"200":{"description":"Bounded catalog match page.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogReviewPage"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/catalog/matches/metrics":{"get":{"operationId":"getPlatformCatalogMatchMetrics","tags":["Catalog review"],"summary":"Return tenant-scoped review queue and accounting-suspense metrics.","security":[{"platformSession":[]}],"responses":{"200":{"description":"Current queue, candidate and suspense counts.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogReviewMetricsResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/catalog/matches/decisions/bulk-exact":{"post":{"operationId":"bulkApproveExactPlatformCatalogMatches","tags":["Catalog review"],"summary":"Approve at most twenty exact catalog candidates with fresh MFA and one idempotent transaction.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogBulkExactDecisionRequest"}}}},"responses":{"200":{"description":"Exact catalog decisions completed atomically or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogBulkExactDecisionResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/catalog/matches/{case}":{"get":{"operationId":"getPlatformCatalogMatch","tags":["Catalog review"],"summary":"Return one opaque catalog match case and its latest reviewed state.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CasePath"}],"responses":{"200":{"description":"Catalog match evidence.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogMatchDetailResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/catalog/matches/{case}/candidates":{"get":{"operationId":"listPlatformCatalogMatchCandidates","tags":["Catalog review"],"summary":"List verified candidate snapshots for one catalog match case.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CasePath"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"Bounded verified candidate page.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogCandidatePage"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/catalog/matches/{case}/disputes":{"parameters":[{"$ref":"#/components/parameters/CasePath"}],"post":{"operationId":"linkPlatformCatalogMatchDispute","tags":["Catalog review"],"summary":"Link one existing tenant dispute to a catalog match case as immutable suspense evidence.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogDisputeLinkRequest"}}}},"responses":{"200":{"description":"Dispute link completed or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogDisputeLinkResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/catalog/matches/{case}/decision":{"post":{"operationId":"decidePlatformCatalogMatch","tags":["Catalog review"],"summary":"Approve, reject, or hold one match with fresh MFA and idempotency.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CasePath"},{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogDecisionRequest"}}}},"responses":{"200":{"description":"Catalog decision completed or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogDecisionResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/anomalies/cases":{"get":{"operationId":"listPlatformAnomalyCases","tags":["Anomalies"],"summary":"List bounded tenant-scoped anomaly cases for authorized operators.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"name":"status","in":"query","schema":{"$ref":"#/components/schemas/AnomalyCaseStatus"}},{"name":"hold_status","in":"query","schema":{"$ref":"#/components/schemas/AnomalyHoldStatus"}},{"name":"class","in":"query","schema":{"$ref":"#/components/schemas/AnomalyClass"}},{"name":"severity","in":"query","schema":{"$ref":"#/components/schemas/AnomalySeverity"}},{"name":"consequence","in":"query","schema":{"$ref":"#/components/schemas/AnomalyConsequence"}},{"name":"assigned_to","in":"query","schema":{"$ref":"#/components/schemas/Uuid"}}],"responses":{"200":{"description":"Bounded anomaly case page.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnomalyCasePage"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/anomalies/cases/{case}":{"get":{"operationId":"getPlatformAnomalyCase","tags":["Anomalies"],"summary":"Return one tenant anomaly case with its immutable comment timeline.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CasePath"}],"responses":{"200":{"description":"Verified anomaly case detail.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnomalyCaseDetailResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/anomalies/cases/metrics":{"get":{"operationId":"getPlatformAnomalyMetrics","tags":["Anomalies"],"summary":"Return tenant anomaly queue and suppression-expiry metrics.","security":[{"platformSession":[]}],"responses":{"200":{"description":"Current tenant anomaly metrics.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnomalyMetricsResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/anomalies/cases/{case}/comments":{"post":{"operationId":"commentPlatformAnomalyCase","tags":["Anomalies"],"summary":"Append one idempotent retained comment to a tenant anomaly case.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CasePath"},{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnomalyCommentRequest"}}}},"responses":{"201":{"description":"Immutable anomaly comment created or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnomalyCommentResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes":{"get":{"operationId":"listPlatformDisputes","tags":["Disputes"],"summary":"List tenant-scoped dispute summaries for approved external finance readers.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/DisputeState"}],"responses":{"200":{"description":"Bounded opaque dispute page.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputePage"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"submitPlatformDispute","tags":["Disputes"],"summary":"Submit one verified-evidence statement dispute and post its capped suspense hold.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitDisputeRequest"}}}},"responses":{"201":{"description":"Dispute and suspense hold created or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmittedDisputeResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes/evidence-manifests":{"post":{"operationId":"uploadPlatformDisputeEvidence","tags":["Disputes"],"summary":"Verify, malware-scan, immutably store, and approve one dispute evidence item.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/UploadDisputeEvidenceRequest"}}}},"responses":{"201":{"description":"Byte-verified clean evidence manifest created or exactly replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadedDisputeEvidenceResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes/{dispute}":{"parameters":[{"$ref":"#/components/parameters/DisputePath"}],"get":{"operationId":"getPlatformDispute","tags":["Disputes"],"summary":"Return verified immutable dispute, event, outcome, and evidence metadata.","security":[{"platformSession":[]}],"responses":{"200":{"description":"Opaque dispute detail without storage keys or evidence digests.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeDetailResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes/{dispute}/acknowledge":{"parameters":[{"$ref":"#/components/parameters/DisputePath"}],"post":{"operationId":"acknowledgePlatformDispute","tags":["Disputes"],"summary":"Acknowledge one open dispute with distinct-actor and idempotency controls.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcknowledgeDisputeRequest"}}}},"responses":{"200":{"description":"Dispute acknowledgement created or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcknowledgedDisputeResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes/{dispute}/assign":{"parameters":[{"$ref":"#/components/parameters/DisputePath"}],"post":{"operationId":"assignPlatformDispute","tags":["Disputes"],"summary":"Assign or reassign one acknowledged open dispute to an approved tenant finance user.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignDisputeRequest"}}}},"responses":{"200":{"description":"Dispute assignment created or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignedDisputeResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes/{dispute}/escalate":{"parameters":[{"$ref":"#/components/parameters/DisputePath"}],"post":{"operationId":"escalatePlatformDispute","tags":["Disputes"],"summary":"Escalate one proposed resolution to a strictly higher tenant finance role.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscalateDisputeRequest"}}}},"responses":{"200":{"description":"Dispute escalation created or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscalatedDisputeResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes/{dispute}/notes":{"parameters":[{"$ref":"#/components/parameters/DisputePath"}],"get":{"operationId":"listPlatformDisputeNotes","tags":["Disputes"],"summary":"List one bounded page of immutable internal dispute notes.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"Opaque internal note page.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeNotePage"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"recordPlatformDisputeNote","tags":["Disputes"],"summary":"Append one immutable internal-only dispute note.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordDisputeNoteRequest"}}}},"responses":{"201":{"description":"Internal dispute note recorded or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordedDisputeNoteResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes/{dispute}/communications":{"parameters":[{"$ref":"#/components/parameters/DisputePath"}],"post":{"operationId":"recordPlatformDisputeCommunication","tags":["Disputes"],"summary":"Append one immutable inbound or outbound external communication under recent MFA.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordDisputeCommunicationRequest"}}}},"responses":{"201":{"description":"External communication evidence recorded or exactly replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordedDisputeCommunicationResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes/{dispute}/evidence/{item}/access":{"parameters":[{"$ref":"#/components/parameters/DisputePath"},{"$ref":"#/components/parameters/EvidenceItemPath"}],"post":{"operationId":"grantPlatformDisputeEvidenceAccess","tags":["Disputes"],"summary":"Grant one short-lived signed and actor-bound evidence download.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Evidence access created or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantedDisputeEvidenceAccessResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes/{dispute}/evidence/{item}/downloads/{access}":{"parameters":[{"$ref":"#/components/parameters/DisputePath"},{"$ref":"#/components/parameters/EvidenceItemPath"},{"$ref":"#/components/parameters/EvidenceAccessPath"}],"get":{"operationId":"downloadPlatformDisputeEvidence","tags":["Disputes"],"summary":"Consume one signed evidence access after immutable object verification.","security":[{"platformSession":[]}],"parameters":[{"name":"expires","in":"query","required":true,"schema":{"type":"integer","minimum":1}},{"name":"signature","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}],"responses":{"200":{"description":"Verified evidence bytes.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"},"X-Content-Type-Options":{"schema":{"type":"string","const":"nosniff"}}},"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes/{dispute}/propose":{"parameters":[{"$ref":"#/components/parameters/DisputePath"}],"post":{"operationId":"proposePlatformDisputeResolution","tags":["Disputes"],"summary":"Propose one immutable outcome as the current assignee after investigation.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposeDisputeRequest"}}}},"responses":{"200":{"description":"Proposed resolution created or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposedDisputeResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes/{dispute}/release":{"parameters":[{"$ref":"#/components/parameters/DisputePath"}],"post":{"operationId":"releasePlatformDispute","tags":["Disputes"],"summary":"Reject or approve withdrawal through an exact maker-checker hold reversal.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseDisputeRequest"}}}},"responses":{"200":{"description":"Dispute hold released or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleasedDisputeResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes/{dispute}/reopen":{"parameters":[{"$ref":"#/components/parameters/DisputePath"}],"post":{"operationId":"reopenPlatformDispute","tags":["Disputes"],"summary":"Create one fresh child dispute from an immutable rejected, withdrawn or upheld case.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReopenDisputeRequest"}}}},"responses":{"201":{"description":"Reopened child dispute created or exactly replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReopenedDisputeResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes/{dispute}/investigate":{"parameters":[{"$ref":"#/components/parameters/DisputePath"}],"post":{"operationId":"investigatePlatformDispute","tags":["Disputes"],"summary":"Start one immutable investigation as the current verified dispute assignee.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvestigateDisputeRequest"}}}},"responses":{"200":{"description":"Dispute investigation created or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvestigatingDisputeResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/disputes/{dispute}/uphold":{"parameters":[{"$ref":"#/components/parameters/DisputePath"}],"post":{"operationId":"upholdPlatformDispute","tags":["Disputes"],"summary":"Uphold only after complete published correction and replacement evidence.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpholdDisputeRequest"}}}},"responses":{"200":{"description":"Correction-bound uphold completed or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpheldDisputeResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/payout-exceptions":{"get":{"operationId":"listPlatformPayoutExceptions","tags":["Payout operations"],"summary":"List bounded secret-safe payout ambiguity and dead-letter cases for external finance readers.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/PayoutExceptionState"}],"responses":{"200":{"description":"Opaque payout exception page without destinations, provider references, signatures, or financial values.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutExceptionPage"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/payout-exceptions/{case}":{"parameters":[{"$ref":"#/components/parameters/PayoutExceptionPath"}],"get":{"operationId":"getPlatformPayoutException","tags":["Payout operations"],"summary":"Return one verified payout exception and its immutable investigation history.","security":[{"platformSession":[]}],"responses":{"200":{"description":"Secret-safe payout exception detail.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutExceptionDetailResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/payout-exceptions/{case}/investigations":{"parameters":[{"$ref":"#/components/parameters/PayoutExceptionPath"}],"post":{"operationId":"investigatePlatformPayoutException","tags":["Payout operations"],"summary":"Append an immutable finding without changing payout or queue state.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvestigatePayoutExceptionRequest"}}}},"responses":{"201":{"description":"Investigation recorded or exactly replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutExceptionEventResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/payout-exceptions/{case}/lookup-rechecks":{"parameters":[{"$ref":"#/components/parameters/PayoutExceptionPath"}],"post":{"operationId":"requestPlatformPayoutLookupRecheck","tags":["Payout operations"],"summary":"Make a recoverable ambiguity due for provider lookup after a distinct checker approves.","description":"This command never submits or resubmits a payout and is unavailable for dead letters.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecheckPayoutExceptionRequest"}}}},"responses":{"200":{"description":"Lookup-only recheck recorded and made due, or exactly replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutLookupRecheckResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/payout-alert-routes":{"get":{"operationId":"listPlatformPayoutAlertRoutes","tags":["Payout operations"],"summary":"List reviewed tenant alert routes without addresses, credentials, hashes, or internal identifiers.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/PayoutAlertRouteStatus"}],"responses":{"200":{"description":"Bounded opaque route-authority page.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutAlertRoutePage"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/payout-alert-routes/{route}":{"parameters":[{"$ref":"#/components/parameters/PayoutAlertRoutePath"}],"get":{"operationId":"getPlatformPayoutAlertRoute","tags":["Payout operations"],"summary":"Return one verified opaque payout-alert route authority.","security":[{"platformSession":[]}],"responses":{"200":{"description":"Verified route authority.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutAlertRouteResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/payout-alert-routes/{route}/retire":{"parameters":[{"$ref":"#/components/parameters/PayoutAlertRoutePath"}],"post":{"operationId":"retirePlatformPayoutAlertRoute","tags":["Payout operations"],"summary":"Retire a route with recent MFA and an actor distinct from its proposer.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Route retired or exactly replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutAlertRouteResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/payout-alert-route-proposals":{"get":{"operationId":"listPlatformPayoutAlertRouteProposals","tags":["Payout operations"],"summary":"List retained maker-checker route proposals for external finance readers.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/PayoutAlertRouteProposalStatus"}],"responses":{"200":{"description":"Bounded verified proposal page.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutAlertRouteProposalPage"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}},"post":{"operationId":"proposePlatformPayoutAlertRoute","tags":["Payout operations"],"summary":"Propose opaque route authority without creating an active delivery route.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposePayoutAlertRouteRequest"}}}},"responses":{"201":{"description":"Proposal created or exactly replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutAlertRouteProposalCommandResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/payout-alert-route-proposals/{proposal}":{"parameters":[{"$ref":"#/components/parameters/PayoutAlertRouteProposalPath"}],"get":{"operationId":"getPlatformPayoutAlertRouteProposal","tags":["Payout operations"],"summary":"Return one verified retained payout-alert route proposal.","security":[{"platformSession":[]}],"responses":{"200":{"description":"Verified proposal authority.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutAlertRouteProposalResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/payout-alert-route-proposals/{proposal}/approve":{"parameters":[{"$ref":"#/components/parameters/PayoutAlertRouteProposalPath"}],"post":{"operationId":"approvePlatformPayoutAlertRouteProposal","tags":["Payout operations"],"summary":"Create route authority after a distinct finance identity approves with recent MFA.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Proposal approved and route created, or exactly replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutAlertRouteApprovalResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/platform/v1/payout-alert-route-proposals/{proposal}/reject":{"parameters":[{"$ref":"#/components/parameters/PayoutAlertRouteProposalPath"}],"post":{"operationId":"rejectPlatformPayoutAlertRouteProposal","tags":["Payout operations"],"summary":"Reject route authority without creating a delivery route.","security":[{"platformSession":[]}],"parameters":[{"$ref":"#/components/parameters/CsrfToken"},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RejectPayoutAlertRouteProposalRequest"}}}},"responses":{"200":{"description":"Proposal rejected or exactly replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutAlertRouteProposalCommandResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/platform/v1/webhooks/inbound/{tenant}/{endpoint}":{"post":{"operationId":"acceptPlatformInboundWebhook","tags":["Webhook ingress"],"summary":"Accept one bounded, signed and ordered partner event.","description":"The guarded route is absent unless generic inbound webhooks and its HTTP boundary are enabled.","security":[],"parameters":[{"name":"tenant","in":"path","required":true,"description":"Opaque external tenant reference bound into endpoint authority.","schema":{"$ref":"#/components/schemas/Uuid"}},{"name":"endpoint","in":"path","required":true,"description":"Opaque webhook endpoint reference.","schema":{"$ref":"#/components/schemas/Uuid"}},{"name":"X-Webhook-Key-Id","in":"header","required":true,"description":"Endpoint key generation identifier.","schema":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[a-z0-9][a-z0-9._:-]*$"}},{"name":"X-Webhook-Timestamp","in":"header","required":true,"description":"Signed event timestamp within the accepted skew window.","schema":{"$ref":"#/components/schemas/IsoDateTime"}},{"name":"X-Webhook-Nonce","in":"header","required":true,"description":"Unique signed request nonce.","schema":{"$ref":"#/components/schemas/Uuid"}},{"name":"X-Webhook-Sequence","in":"header","required":true,"description":"Strictly increasing endpoint sequence number.","schema":{"type":"integer","minimum":1}},{"name":"X-Webhook-Event","in":"header","required":true,"description":"Stable partner event reference used for exact replay.","schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[a-z0-9][a-z0-9._:-]*$"}},{"name":"X-Webhook-Schema","in":"header","required":true,"description":"Endpoint-bound payload schema version.","schema":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[a-z0-9][a-z0-9._:-]*$"}},{"name":"X-Webhook-Signature","in":"header","required":true,"description":"Lowercase hexadecimal HMAC-SHA256 over the canonical signed envelope.","schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookIngressPayload"}}}},"responses":{"202":{"description":"Event accepted or exactly replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookIngressResponse"}}}},"401":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"platformSession":{"type":"apiKey","in":"cookie","name":"laravel_session"},"basicClient":{"type":"http","scheme":"basic"},"bearerToken":{"type":"http","scheme":"bearer","bearerFormat":"opaque"}},"headers":{"NoStore":{"description":"Sensitive responses are never cacheable.","required":true,"schema":{"type":"string","const":"no-store, private"}}},"parameters":{"CsrfToken":{"name":"X-XSRF-TOKEN","in":"header","required":true,"description":"CSRF token paired with the current web session.","schema":{"type":"string","minLength":1,"maxLength":2048}},"TenantHeader":{"name":"X-Tenant-ID","in":"header","required":true,"description":"Opaque external tenant reference.","schema":{"$ref":"#/components/schemas/Uuid"}},"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"ImportPath":{"name":"importRef","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Uuid"}},"ExportPath":{"name":"export","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Uuid"}},"MappingProposalPath":{"name":"proposalRef","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Uuid"}},"ClientPath":{"name":"client","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Uuid"}},"TokenPath":{"name":"token","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Uuid"}},"CasePath":{"name":"case","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Uuid"}},"DisputePath":{"name":"dispute","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Uuid"}},"PayoutExceptionPath":{"name":"case","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Uuid"}},"PayoutAlertRoutePath":{"name":"route","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Uuid"}},"PayoutAlertRouteProposalPath":{"name":"proposal","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Uuid"}},"EvidenceItemPath":{"name":"item","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Uuid"}},"EvidenceAccessPath":{"name":"access","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Uuid"}},"IdentitySessionPath":{"name":"session","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Uuid"}},"Cursor":{"name":"cursor","in":"query","required":false,"schema":{"$ref":"#/components/schemas/NullableUuid"}},"Limit":{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},"CatalogReviewState":{"name":"state","in":"query","required":false,"schema":{"type":"string","enum":["unreviewed","all"],"default":"unreviewed"}},"DisputeState":{"name":"state","in":"query","required":false,"schema":{"type":"string","enum":["open","rejected","withdrawn","upheld","all"],"default":"open"}},"PayoutExceptionState":{"name":"state","in":"query","required":false,"schema":{"type":"string","enum":["open","actionable","ambiguous","dead_lettered","resolved","all"],"default":"open"}},"PayoutAlertRouteStatus":{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["active","retired","all"],"default":"all"}},"PayoutAlertRouteProposalStatus":{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","approved","rejected","all"],"default":"all"}}},"responses":{"Error":{"description":"Stable error envelope.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"ExportOk":{"description":"Safe export lifecycle state without delivery or object authority.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportResponse"}}}},"ExportPageOk":{"description":"Bounded page of safe export lifecycle states without delivery or object authority.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportPageResponse"}}}},"ExportDownloadOk":{"description":"Complete verified export bytes. Range and partial-content delivery are unsupported.","headers":{"Content-Disposition":{"required":true,"description":"Safe attachment filename derived only from the opaque export reference and allowlisted format.","schema":{"type":"string","pattern":"^attachment; filename=\"[A-Za-z0-9._-]+\\.(?:csv|json|parquet|pdf|zip)\"$"}},"Content-Length":{"required":true,"description":"Exact verified complete artifact length in bytes.","schema":{"type":"integer","minimum":1}},"Cache-Control":{"$ref":"#/components/headers/NoStore"},"X-Content-Type-Options":{"required":true,"schema":{"type":"string","const":"nosniff"}}},"content":{"application/json":{"schema":{"type":"string","format":"binary"}},"text/csv":{"schema":{"type":"string","format":"binary"}},"application/pdf":{"schema":{"type":"string","format":"binary"}},"application/zip":{"schema":{"type":"string","format":"binary"}},"application/vnd.apache.parquet":{"schema":{"type":"string","format":"binary"}}}},"ExportRequestAccepted":{"description":"Export request created or exactly replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportCreateResponse"}}}},"PlatformSessionOk":{"description":"Current platform session.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformSessionResponse"}}}},"PlatformSessionCreated":{"description":"Identity and tenant session created.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformSessionResponse"}}}},"ManagedApiClientOk":{"description":"API-client command completed or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManagedApiClientResponse"}}}},"ManagedApiClientCreated":{"description":"API client issued. The secret appears only in this response and a short exact replay window.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManagedApiClientResponse"}}}},"ImportOk":{"description":"Import returned or exact create replay completed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportResponse"}}}},"ImportCreated":{"description":"Tenant-owned import created.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportResponse"}}}},"UploadSessionOk":{"description":"Exact upload-session replay returned.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadSessionResponse"}}}},"UploadSessionCreated":{"description":"One-time resumable upload authority issued.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadSessionResponse"}}}},"ImportProfileAccepted":{"description":"Durable profiling work accepted.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportProfileResponse"}}}},"ImportMappingSuggestionsOk":{"description":"Bounded advisory mapping suggestions requiring human review.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportMappingSuggestionsResponse"}}}},"ImportCommandOk":{"description":"Import command completed or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportCommandResponse"}}}},"MappingReviewPageOk":{"description":"Bounded imports awaiting human mapping review.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MappingReviewPageResponse"}}}},"MappingPreviewOk":{"description":"Validated mapping preview with source coverage.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MappingPreviewResponse"}}}},"MappingApprovalOk":{"description":"Human-reviewed mapping approval completed or replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MappingApprovalResponse"}}}},"MappingProposalPolicyOk":{"description":"Current maker-checker policy and latest proposal returned.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MappingProposalPolicyResponse"}}}},"MappingProposalCreated":{"description":"Immutable mapping proposal created or exactly replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MappingProposalResponse"}}}},"MappingProposalDecisionOk":{"description":"Mapping proposal decision completed or exactly replayed.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MappingProposalDecisionResponse"}}}},"ReconciliationPageOk":{"description":"Bounded completed canonical reconciliations with validation evidence.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReconciliationPageResponse"}}}},"ReconciliationDetailOk":{"description":"Exact complete-file canonical and validation evidence.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReconciliationDetailResponse"}}}},"PublishedAnalyticsSummaryOk":{"description":"Exact summary from published generations only.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishedAnalyticsSummaryResponse"}}}},"PublishedAnalyticsFilterOptionsOk":{"description":"Privacy-protected filter options from published generations only.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishedAnalyticsFilterOptionsResponse"}}}},"PublishedAnalyticsReadinessOk":{"description":"Aggregate published analytics availability and freshness.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishedAnalyticsReadinessResponse"}}}},"PublishedObservedRatePageOk":{"description":"Bounded exact observed-rate page from published generations only.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishedObservedRatePage"}}}},"PublishedAnalyticsBreakdownPageOk":{"description":"Bounded exact commercial-dimension breakdown from published generations only.","headers":{"Cache-Control":{"$ref":"#/components/headers/NoStore"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishedAnalyticsBreakdownPage"}}}}},"schemas":{"Uuid":{"type":"string","format":"uuid"},"NullableUuid":{"type":["string","null"],"format":"uuid"},"IsoDateTime":{"type":"string","format":"date-time"},"NullableIsoDateTime":{"type":["string","null"],"format":"date-time"},"CurrencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"CurrencyBasis":{"type":"string","enum":["reported","settlement"]},"RateBasis":{"type":"string","enum":["streams","units"]},"ReportMonth":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-01$"},"CommercialDimension":{"type":"string","enum":["dsp","territory","service_tier","subscription_plan","subscriber_type","commercial_model","use_type","offer","device","quality","channel"]},"CommercialValueState":{"type":"string","enum":["mapped","unknown","not_supplied","not_applicable","invalid"]},"Scope":{"type":"string","enum":["analytics:read","calculations:read","calculations:write","catalog:read","catalog:write","exports:read","exports:write","imports:read","imports:write","ledger:read","payees:read","payees:write","statements:read","tenant:read","webhooks:read","webhooks:write"]},"ExportClass":{"type":"string","enum":["dashboard_extract","canonical_detail","rejected_rows","allocation_detail","statement","ledger_reconciliation","audit_evidence"]},"ExportFormat":{"type":"string","enum":["csv","json","parquet","pdf","zip"]},"ExportStatus":{"type":"string","enum":["queued","generating","validating","ready","failed","cancelled","expired","revoked"]},"ExportReportingPeriod":{"type":"object","additionalProperties":false,"required":["from","to"],"properties":{"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"}}},"ExportFilterValue":{"oneOf":[{"type":"string","minLength":1,"maxLength":200},{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","minLength":1,"maxLength":200}}]},"ExportSpecification":{"type":"object","additionalProperties":false,"required":["currency_basis","filters","locale","max_bytes","payee_ref","reporting_period","schema_version","source_ref","source_type","timezone"],"properties":{"currency_basis":{"type":["string","null"],"enum":["reported","settlement","tenant_reporting",null]},"filters":{"type":"object","maxProperties":50,"propertyNames":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"additionalProperties":{"$ref":"#/components/schemas/ExportFilterValue"}},"locale":{"type":"string","pattern":"^[a-z]{2,3}(?:-[A-Z]{2})?$"},"max_bytes":{"type":"integer","minimum":1,"maximum":53687091200},"payee_ref":{"$ref":"#/components/schemas/NullableUuid"},"reporting_period":{"$ref":"#/components/schemas/ExportReportingPeriod"},"schema_version":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$"},"source_ref":{"$ref":"#/components/schemas/Uuid"},"source_type":{"type":"string","enum":["analytics_generation","canonical_manifest","calculation_run","statement","ledger_period","audit_window"]},"timezone":{"type":"string","minLength":1,"maxLength":80}}},"CreateExportRequest":{"type":"object","additionalProperties":false,"required":["export_class","format","specification"],"allOf":[{"if":{"required":["export_class","format"],"properties":{"export_class":{"const":"ledger_reconciliation"},"format":{"const":"json"}}},"then":{"properties":{"specification":{"allOf":[{"$ref":"#/components/schemas/ExportSpecification"},{"type":"object","properties":{"currency_basis":{"type":["string","null"],"enum":["reported",null]},"filters":{"type":"object","maxProperties":0},"locale":{"const":"en"},"max_bytes":{"type":"integer","minimum":1,"maximum":1048576},"payee_ref":{"type":"null"},"schema_version":{"const":"v1"},"source_type":{"const":"ledger_period"},"timezone":{"const":"UTC"}}}]}}}}],"properties":{"export_class":{"$ref":"#/components/schemas/ExportClass"},"format":{"$ref":"#/components/schemas/ExportFormat"},"specification":{"$ref":"#/components/schemas/ExportSpecification"},"max_attempts":{"type":"integer","minimum":1,"maximum":20,"default":5},"retention_days":{"type":"integer","minimum":1,"maximum":30,"default":7}}},"ExportCommandRequest":{"type":"object","additionalProperties":false,"required":["reason"],"properties":{"reason":{"type":"string","minLength":8,"maxLength":500}}},"ExportArtifactSummary":{"type":"object","additionalProperties":false,"required":["artifact","format","media_type","bytes","row_count","expires_at"],"properties":{"artifact":{"$ref":"#/components/schemas/Uuid"},"format":{"$ref":"#/components/schemas/ExportFormat"},"media_type":{"type":"string","minLength":1,"maxLength":120},"bytes":{"type":"integer","minimum":1},"row_count":{"type":["integer","null"],"minimum":0},"expires_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"ExportState":{"type":"object","additionalProperties":false,"required":["request","export_class","format","status","requested_at","ready_at","failed_at","cancelled_at","expired_at","revoked_at","expires_at","artifact"],"properties":{"request":{"$ref":"#/components/schemas/Uuid"},"export_class":{"$ref":"#/components/schemas/ExportClass"},"format":{"$ref":"#/components/schemas/ExportFormat"},"status":{"$ref":"#/components/schemas/ExportStatus"},"requested_at":{"$ref":"#/components/schemas/IsoDateTime"},"ready_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"failed_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"cancelled_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"expired_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"revoked_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"expires_at":{"$ref":"#/components/schemas/IsoDateTime"},"artifact":{"oneOf":[{"$ref":"#/components/schemas/ExportArtifactSummary"},{"type":"null"}]}}},"ExportResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ExportState"}}},"ExportPageResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/ExportState"}},"meta":{"type":"object","additionalProperties":false,"required":["next_cursor"],"properties":{"next_cursor":{"$ref":"#/components/schemas/NullableUuid"}}}}},"ExportCreateResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ExportState"},"meta":{"$ref":"#/components/schemas/ReplayMeta"}}},"CreateImportRequest":{"type":"object","additionalProperties":false,"required":["source","provider","report_type","file"],"properties":{"source":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$","maxLength":120},"provider":{"type":"string","minLength":1,"maxLength":120},"report_type":{"type":"string","minLength":1,"maxLength":120},"commercial_taxonomy":{"description":"Optional approved commercial-taxonomy version to freeze for rate-capable analytics.","allOf":[{"$ref":"#/components/schemas/Uuid"}]},"statement_period":{"$ref":"#/components/schemas/StatementPeriod"},"file":{"$ref":"#/components/schemas/ExpectedImportFile"},"metadata":{"type":"object","maxProperties":50,"additionalProperties":true}}},"StatementPeriod":{"type":"object","additionalProperties":false,"properties":{"start":{"type":["string","null"],"format":"date"},"end":{"type":["string","null"],"format":"date"}}},"ExpectedImportFile":{"type":"object","additionalProperties":false,"required":["original_name","media_type","expected_bytes","sha256"],"properties":{"original_name":{"type":"string","minLength":1,"maxLength":500},"media_type":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9.+-]*/[A-Za-z0-9][A-Za-z0-9.+-]*$","maxLength":160},"expected_bytes":{"type":"integer","minimum":1,"maximum":536870912000},"sha256":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"}}},"ProfileImportRequest":{"type":"object","additionalProperties":false,"properties":{"source_file_ref":{"$ref":"#/components/schemas/NullableUuid"},"parsing":{"$ref":"#/components/schemas/ImportParsing"}}},"ImportParsing":{"type":"object","additionalProperties":false,"properties":{"format":{"type":"string","enum":["delimited","fixed_width","jsonl","xlsx"]},"encoding":{"type":"string","enum":["UTF-8","UTF-16LE","UTF-16BE","Windows-1252","ISO-8859-1"]},"delimiter":{"type":"string","enum":["comma","semicolon","tab","pipe"]},"quote":{"type":"string","enum":["double_quote","none"]},"header_row":{"type":"integer","minimum":1,"maximum":1000},"rows_to_skip":{"type":"integer","minimum":0,"maximum":100000},"footer_rows":{"type":"integer","minimum":0,"maximum":100000},"sheet_name":{"type":"string","minLength":1,"maxLength":160},"fixed_width":{"type":"array","minItems":1,"maxItems":512,"items":{"$ref":"#/components/schemas/FixedWidthColumn"}},"record_path":{"type":"array","minItems":1,"maxItems":16,"items":{"type":"string","minLength":1,"maxLength":255}},"xml_record_path":{"type":"array","minItems":1,"maxItems":16,"items":{"type":"string","minLength":1,"maxLength":640}}}},"FixedWidthColumn":{"type":"object","additionalProperties":false,"required":["source","start","length"],"properties":{"source":{"type":"string","minLength":1,"maxLength":255},"start":{"type":"integer","minimum":1,"maximum":104857600},"length":{"type":"integer","minimum":1,"maximum":104857600},"trim":{"type":"string","enum":["both","right","none"]}}},"CancelImportRequest":{"type":"object","additionalProperties":false,"required":["reason"],"properties":{"reason":{"type":"string","minLength":1,"maxLength":500}}},"ImportState":{"type":"string","enum":["created","uploading","quarantined","profiling","awaiting_mapping","canonicalizing","validating","ready_for_calculation","calculating","reconciled","approved","published","failed","cancelled","rejected","replaced","superseded"]},"ImportRecord":{"type":"object","additionalProperties":false,"required":["ref","state","source","provider","report_type","statement_period","expected_bytes","counts"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"state":{"$ref":"#/components/schemas/ImportState"},"source":{"type":"string","maxLength":120},"provider":{"type":"string","maxLength":120},"report_type":{"type":"string","maxLength":120},"statement_period":{"$ref":"#/components/schemas/StatementPeriod"},"expected_bytes":{"type":"integer","minimum":1},"schema_fingerprint":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"counts":{"$ref":"#/components/schemas/ImportCounts"},"reconciliation":{"type":["object","null"],"additionalProperties":true},"file":{"$ref":"#/components/schemas/NullableImportFile"},"mapping":{"$ref":"#/components/schemas/NullableImportMapping"},"profiling":{"$ref":"#/components/schemas/NullableImportProfiling"},"profile":{"type":["object","null"],"additionalProperties":true},"terminal_reason":{"type":["string","null"],"maxLength":500},"published_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"created_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"updated_at":{"$ref":"#/components/schemas/NullableIsoDateTime"}}},"ImportCounts":{"type":"object","additionalProperties":false,"required":["accepted","rejected"],"properties":{"accepted":{"type":"integer","minimum":0},"rejected":{"type":"integer","minimum":0}}},"NullableImportFile":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ImportFile"}]},"ImportFile":{"type":"object","additionalProperties":false,"required":["ref","name","media_type","bytes","sha256","verified_at"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"name":{"type":"string","maxLength":500},"media_type":{"type":"string","maxLength":160},"bytes":{"type":"integer","minimum":1},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"verified_at":{"$ref":"#/components/schemas/NullableIsoDateTime"}}},"NullableImportMapping":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ImportMapping"}]},"ImportMapping":{"type":"object","additionalProperties":false,"required":["ref","version","status","schema_fingerprint"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"version":{"type":"integer","minimum":1},"status":{"type":"string","enum":["draft","approved","superseded"]},"schema_fingerprint":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"NullableImportProfiling":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ImportProfiling"}]},"ImportProfiling":{"type":"object","additionalProperties":false,"required":["ref","status","attempts","source_file_ref","error_code","completed_at"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"status":{"type":"string","enum":["pending","running","complete","failed","cancelled"]},"attempts":{"type":"integer","minimum":0},"source_file_ref":{"$ref":"#/components/schemas/NullableUuid"},"error_code":{"type":["string","null"],"maxLength":120},"completed_at":{"$ref":"#/components/schemas/NullableIsoDateTime"}}},"ImportResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ImportRecord"},"meta":{"$ref":"#/components/schemas/ReplayMeta"}}},"ImportCommandResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["import"],"properties":{"import":{"$ref":"#/components/schemas/ImportRecord"}}}}},"ImportMappingSuggestionHeader":{"type":"object","additionalProperties":false,"required":["position","source","key","inferred_type","sample_count","null_count","distinct_count","suggestions"],"properties":{"position":{"type":"integer","minimum":0,"maximum":511},"source":{"type":"string","maxLength":255},"key":{"type":"string","maxLength":255},"inferred_type":{"type":"string","maxLength":40},"sample_count":{"type":"integer","minimum":0,"maximum":100},"null_count":{"type":"integer","minimum":0,"maximum":100},"distinct_count":{"type":"integer","minimum":0,"maximum":100},"suggestions":{"type":"array","maxItems":3,"items":{"$ref":"#/components/schemas/MappingSuggestion"}}}},"MappingRequiredGroup":{"type":"object","additionalProperties":false,"required":["label","any_of"],"properties":{"label":{"type":"string","minLength":1,"maxLength":120},"any_of":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"string","minLength":1,"maxLength":120}},"covered_by_suggestion":{"type":"boolean"}}},"ImportMappingSuggestionsResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["import","provider","report_type","schema_fingerprint","format","suggestion_policy","headers","required_groups","authority"],"properties":{"import":{"$ref":"#/components/schemas/Uuid"},"provider":{"type":"string","maxLength":120},"report_type":{"type":"string","maxLength":120},"schema_fingerprint":{"type":"string","pattern":"^[a-f0-9]{64}$"},"format":{"type":"string","maxLength":40},"suggestion_policy":{"$ref":"#/components/schemas/MappingSuggestionPolicy"},"headers":{"type":"array","maxItems":512,"items":{"$ref":"#/components/schemas/ImportMappingSuggestionHeader"}},"required_groups":{"type":"array","maxItems":20,"items":{"allOf":[{"$ref":"#/components/schemas/MappingRequiredGroup"},{"type":"object","required":["covered_by_suggestion"],"properties":{"covered_by_suggestion":{"type":"boolean"}}}]}},"authority":{"type":"object","additionalProperties":false,"required":["human_review_required","machine_approval_allowed"],"properties":{"human_review_required":{"type":"boolean","const":true},"machine_approval_allowed":{"type":"boolean","const":false}}}}}}},"MappingReviewPageResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/ImportRecord"}},"meta":{"type":"object","additionalProperties":false,"required":["next_cursor"],"properties":{"next_cursor":{"$ref":"#/components/schemas/NullableUuid"}}}}},"CompleteReconciliationCounts":{"type":"object","additionalProperties":false,"required":["processed","accepted","rejected","blank","footer","covered","unreconciled"],"properties":{"processed":{"type":"integer","minimum":0},"accepted":{"type":"integer","minimum":0},"rejected":{"type":"integer","minimum":0},"blank":{"type":"integer","minimum":0},"footer":{"type":"integer","minimum":0},"covered":{"type":"integer","minimum":0},"unreconciled":{"type":"integer","minimum":0}}},"CompleteReconciliationSummary":{"type":"object","additionalProperties":false,"required":["run","import","provider","report_type","statement_period","state","validation_status","counts","balanced","completed_at"],"properties":{"run":{"$ref":"#/components/schemas/Uuid"},"import":{"$ref":"#/components/schemas/Uuid"},"provider":{"type":"string","maxLength":120},"report_type":{"type":"string","maxLength":120},"statement_period":{"$ref":"#/components/schemas/StatementPeriod"},"state":{"$ref":"#/components/schemas/ImportState"},"validation_status":{"type":"string","enum":["passed","failed"]},"counts":{"$ref":"#/components/schemas/CompleteReconciliationCounts"},"balanced":{"type":"boolean"},"completed_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"ReconciliationPageResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/CompleteReconciliationSummary"}},"meta":{"type":"object","additionalProperties":false,"required":["next_cursor"],"properties":{"next_cursor":{"$ref":"#/components/schemas/NullableUuid"}}}}},"ReconciliationImportFile":{"type":"object","additionalProperties":false,"required":["ref","name","media_type","bytes","verified_at"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"name":{"type":"string","maxLength":500},"media_type":{"type":"string","maxLength":160},"bytes":{"type":"integer","minimum":1},"verified_at":{"$ref":"#/components/schemas/NullableIsoDateTime"}}},"NullableReconciliationImportFile":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ReconciliationImportFile"}]},"ReconciliationMapping":{"type":"object","additionalProperties":false,"required":["ref","version","status"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"version":{"type":"integer","minimum":1},"status":{"type":"string","enum":["draft","approved","superseded"]}}},"NullableReconciliationMapping":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ReconciliationMapping"}]},"ReconciliationImport":{"type":"object","additionalProperties":false,"required":["ref","state","source","provider","report_type","statement_period","file","mapping","terminal_reason"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"state":{"$ref":"#/components/schemas/ImportState"},"source":{"type":"string","maxLength":120},"provider":{"type":"string","maxLength":120},"report_type":{"type":"string","maxLength":120},"statement_period":{"$ref":"#/components/schemas/StatementPeriod"},"file":{"$ref":"#/components/schemas/NullableReconciliationImportFile"},"mapping":{"$ref":"#/components/schemas/NullableReconciliationMapping"},"terminal_reason":{"type":["string","null"],"maxLength":500}}},"CompleteFileTotals":{"type":"object","propertyNames":{"pattern":"^[A-Z]{3}$"},"maxProperties":180,"additionalProperties":{"$ref":"#/components/schemas/MappingSampleCurrencyTotals"}},"CompleteFileReconciliation":{"type":"object","additionalProperties":false,"required":["balanced","covered_rows","unreconciled_rows","differences"],"properties":{"balanced":{"type":"boolean"},"covered_rows":{"type":"integer","minimum":0},"unreconciled_rows":{"type":"integer","minimum":0},"differences":{"$ref":"#/components/schemas/CompleteFileTotals"}}},"CanonicalizationEvidence":{"type":"object","additionalProperties":false,"required":["ref","status","engine_version","schema_version","processed_rows","accepted_rows","rejected_rows","blank_rows","footer_rows","source_totals","mapped_totals","rejected_totals","reconciliation","completed_at"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"status":{"type":"string","const":"complete"},"engine_version":{"type":"string","minLength":1,"maxLength":120},"schema_version":{"type":"string","minLength":1,"maxLength":120},"processed_rows":{"type":"integer","minimum":0},"accepted_rows":{"type":"integer","minimum":0},"rejected_rows":{"type":"integer","minimum":0},"blank_rows":{"type":"integer","minimum":0},"footer_rows":{"type":"integer","minimum":0},"source_totals":{"$ref":"#/components/schemas/CompleteFileTotals"},"mapped_totals":{"$ref":"#/components/schemas/CompleteFileTotals"},"rejected_totals":{"$ref":"#/components/schemas/CompleteFileTotals"},"reconciliation":{"$ref":"#/components/schemas/CompleteFileReconciliation"},"completed_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"ValidationEvidence":{"type":"object","additionalProperties":false,"required":["ref","status","run_number","accepted_rows","rejected_rows","source_totals","mapped_totals","reconciliation","failure_summary","completed_at"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"status":{"type":"string","enum":["passed","failed"]},"run_number":{"type":"integer","minimum":1},"accepted_rows":{"type":"integer","minimum":0},"rejected_rows":{"type":"integer","minimum":0},"source_totals":{"$ref":"#/components/schemas/CompleteFileTotals"},"mapped_totals":{"$ref":"#/components/schemas/CompleteFileTotals"},"reconciliation":{"$ref":"#/components/schemas/CompleteFileReconciliation"},"failure_summary":{"type":["object","null"],"additionalProperties":true},"completed_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"CompleteReconciliationDetail":{"type":"object","additionalProperties":false,"required":["import","canonicalization","validation"],"properties":{"import":{"$ref":"#/components/schemas/ReconciliationImport"},"canonicalization":{"$ref":"#/components/schemas/CanonicalizationEvidence"},"validation":{"$ref":"#/components/schemas/ValidationEvidence"},"publication":{"$ref":"#/components/schemas/NullablePublicationReconciliationEvidence"}}},"CalculationSourceCurrencyTotals":{"type":"object","additionalProperties":false,"required":["gross","net"],"properties":{"gross":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"net":{"$ref":"#/components/schemas/SignedCanonicalDecimal"}}},"CalculationSourceTotals":{"type":"object","propertyNames":{"pattern":"^[A-Z]{3}$"},"maxProperties":180,"additionalProperties":{"$ref":"#/components/schemas/CalculationSourceCurrencyTotals"}},"CalculationResultCurrencyTotals":{"type":"object","additionalProperties":false,"required":["earnings","reserves","fees","deductions","recoupment","withholding","payable"],"properties":{"earnings":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"reserves":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"fees":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"deductions":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"recoupment":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"withholding":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"payable":{"$ref":"#/components/schemas/SignedCanonicalDecimal"}}},"CalculationResultTotals":{"type":"object","propertyNames":{"pattern":"^[A-Z]{3}$"},"maxProperties":180,"additionalProperties":{"$ref":"#/components/schemas/CalculationResultCurrencyTotals"}},"PayableTotals":{"type":"object","propertyNames":{"pattern":"^[A-Z]{3}$"},"maxProperties":180,"additionalProperties":{"$ref":"#/components/schemas/SignedCanonicalDecimal"}},"PublicationReconciliationReport":{"type":"object","additionalProperties":false,"required":["scope","balanced","import","canonicalization","analytics","calculation","allocations","ledger","statements"],"properties":{"scope":{"type":"string","const":"published_generation"},"balanced":{"type":"boolean","const":true},"import":{"$ref":"#/components/schemas/Uuid"},"canonicalization":{"type":"object","additionalProperties":false,"required":["ref","rows","totals"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"rows":{"type":"integer","minimum":0},"totals":{"$ref":"#/components/schemas/CompleteFileTotals"}}},"analytics":{"type":"object","additionalProperties":false,"required":["ref","status","facts_rows","cube_rows","facts_totals","cube_totals"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"status":{"type":"string","enum":["published","superseded"]},"facts_rows":{"type":"integer","minimum":0},"cube_rows":{"type":"integer","minimum":0},"rate_required":{"type":"boolean"},"rate_rows":{"type":"integer","minimum":0},"rate_groups":{"type":"integer","minimum":0},"facts_totals":{"$ref":"#/components/schemas/CompleteFileTotals"},"cube_totals":{"$ref":"#/components/schemas/CompleteFileTotals"}}},"calculation":{"type":"object","additionalProperties":false,"required":["ref","source_totals","result_totals"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"source_totals":{"$ref":"#/components/schemas/CalculationSourceTotals"},"result_totals":{"$ref":"#/components/schemas/CalculationResultTotals"}}},"allocations":{"type":"object","additionalProperties":false,"required":["count","totals"],"properties":{"count":{"type":"integer","minimum":1},"totals":{"$ref":"#/components/schemas/CalculationResultTotals"}}},"ledger":{"type":"object","additionalProperties":false,"required":["count","payable_totals"],"properties":{"count":{"type":"integer","minimum":1},"payable_totals":{"$ref":"#/components/schemas/PayableTotals"}}},"statements":{"type":"object","additionalProperties":false,"required":["count","totals"],"properties":{"count":{"type":"integer","minimum":1},"totals":{"$ref":"#/components/schemas/CalculationResultTotals"}}}}},"PublicationReconciliationEvidence":{"type":"object","additionalProperties":false,"required":["ref","reconciled_at","report"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"reconciled_at":{"$ref":"#/components/schemas/IsoDateTime"},"report":{"$ref":"#/components/schemas/PublicationReconciliationReport"}}},"NullablePublicationReconciliationEvidence":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/PublicationReconciliationEvidence"}]},"ReconciliationDetailResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/CompleteReconciliationDetail"}}},"MappingDefinitionRequest":{"type":"object","additionalProperties":false,"required":["profile","mapping"],"properties":{"profile":{"$ref":"#/components/schemas/SourceProfileSelection"},"mapping":{"$ref":"#/components/schemas/MappingDefinition"}}},"SourceProfileSelection":{"type":"object","additionalProperties":false,"anyOf":[{"required":["ref"]},{"required":["name"]}],"properties":{"ref":{"$ref":"#/components/schemas/NullableUuid"},"name":{"type":["string","null"],"minLength":1,"maxLength":160},"filename_rules":{"type":"array","maxItems":20,"items":{"$ref":"#/components/schemas/SourceSelectionRule"}},"archive_member_rules":{"type":"array","maxItems":20,"items":{"$ref":"#/components/schemas/SourceSelectionRule"}},"sheet_name":{"type":["string","null"],"minLength":1,"maxLength":160}}},"SourceSelectionRule":{"type":"object","additionalProperties":false,"required":["match","value"],"properties":{"match":{"type":"string","enum":["exact","prefix","suffix"]},"value":{"type":"string","minLength":1,"maxLength":500}}},"MappingDefinition":{"type":"object","additionalProperties":false,"required":["columns"],"properties":{"columns":{"type":"array","minItems":1,"maxItems":512,"items":{"$ref":"#/components/schemas/MappingColumn"}},"validation_rules":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":true}},"reconciliation_rules":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":true}}}},"MappingColumn":{"type":"object","additionalProperties":false,"required":["source","target"],"properties":{"source":{"type":"string","minLength":1,"maxLength":255},"target":{"type":"string","minLength":1,"maxLength":120},"transforms":{"type":"array","maxItems":20,"items":{"$ref":"#/components/schemas/MappingTransform"}}}},"MappingTransform":{"type":"object","additionalProperties":false,"required":["op"],"properties":{"op":{"type":"string","enum":["trim","lowercase","uppercase","null_if_empty","default","replace","lookup","parse_decimal","parse_date","negate","absolute","prefix","suffix"]},"value":{"type":["string","integer","boolean","null"]},"from":{"type":"string"},"to":{"type":"string"},"map":{"type":"object","maxProperties":1000,"additionalProperties":true},"default":{"type":["string","integer","boolean","null"]},"decimal_separator":{"type":"string","enum":[".",","]},"thousands_separator":{"type":["string","null"],"enum":[".",","," ","'",null]},"formats":{"type":"array","minItems":1,"maxItems":7,"items":{"type":"string"}}}},"MappingReviewProfile":{"type":"object","additionalProperties":false,"required":["schema_fingerprint","format","sheet_name","sampled_rows","headers"],"properties":{"schema_fingerprint":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"suggestion_policy":{"$ref":"#/components/schemas/MappingSuggestionPolicy"},"format":{"type":["string","null"],"enum":["delimited","fixed_width","jsonl","xlsx",null]},"sheet_name":{"type":["string","null"],"maxLength":160},"record_path":{"type":["array","null"],"minItems":1,"maxItems":16,"items":{"type":"string","minLength":1,"maxLength":255}},"adapter":{"type":["string","null"],"enum":["xml",null]},"sampled_rows":{"type":"integer","minimum":0,"maximum":100},"required_groups":{"type":"array","maxItems":20,"items":{"$ref":"#/components/schemas/MappingRequiredGroup"}},"headers":{"type":"array","maxItems":512,"items":{"$ref":"#/components/schemas/MappingProfileHeader"}}}},"MappingProfileHeader":{"type":"object","additionalProperties":true,"required":["position","source","key","sample_values","sample_count","null_count","distinct_count","inferred_type","suggestions"],"properties":{"position":{"type":"integer","minimum":0,"maximum":511},"source":{"type":"string","maxLength":255},"key":{"type":"string","maxLength":255},"sample_values":{"type":"array","maxItems":5,"items":{"type":["string","null"],"maxLength":2000}},"sample_count":{"type":"integer","minimum":0,"maximum":100},"null_count":{"type":"integer","minimum":0,"maximum":100},"distinct_count":{"type":"integer","minimum":0,"maximum":100},"inferred_type":{"type":"string","maxLength":40},"suggestions":{"type":"array","maxItems":10,"items":{"$ref":"#/components/schemas/MappingSuggestion"}}}},"MappingSuggestion":{"type":"object","additionalProperties":false,"required":["field","confidence","reason"],"properties":{"field":{"type":"string","maxLength":120},"confidence":{"type":"string","pattern":"^(?:0(?:\\.\\d{1,10})?|1(?:\\.0{1,10})?)$"},"reason":{"type":"string","maxLength":80}}},"MappingSuggestionPolicy":{"type":"object","additionalProperties":false,"required":["engine","canonical_schema","provider_aliases","provider_aliases_sha256","bulk_apply_min_confidence"],"properties":{"engine":{"type":"string","const":"column-suggestion-v1"},"canonical_schema":{"type":"string","pattern":"^canonical-schema-v[1-9][0-9]*$"},"provider_aliases":{"type":"string","const":"provider-mapping-aliases-v1"},"provider_aliases_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"bulk_apply_min_confidence":{"type":"string","const":"0.90"}}},"MappingCoverage":{"type":"object","additionalProperties":false,"required":["source_columns","mapped_columns","unmapped_sources"],"properties":{"source_columns":{"type":"integer","minimum":0,"maximum":512},"mapped_columns":{"type":"integer","minimum":0,"maximum":512},"unmapped_sources":{"type":"array","maxItems":512,"items":{"type":"string","maxLength":255}}}},"MappingPreviewResult":{"type":"object","additionalProperties":false,"required":["rows","errors","error_count"],"properties":{"rows":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":true}},"errors":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":true}},"error_count":{"type":"integer","minimum":0},"reconciliation":{"$ref":"#/components/schemas/MappingSampleReconciliation"}}},"SignedCanonicalDecimal":{"type":"string","pattern":"^-?(?:0|[1-9][0-9]{0,25})\\.[0-9]{12}$"},"MappingSampleCurrencyTotals":{"type":"object","additionalProperties":false,"properties":{"units":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"duration_seconds":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"gross_revenue":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"deductions":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"taxes":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"costs":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"net_revenue":{"$ref":"#/components/schemas/SignedCanonicalDecimal"}}},"MappingSampleCurrencyCoverage":{"type":"object","additionalProperties":false,"properties":{"units":{"type":"integer","minimum":0,"maximum":100},"duration_seconds":{"type":"integer","minimum":0,"maximum":100},"gross_revenue":{"type":"integer","minimum":0,"maximum":100},"deductions":{"type":"integer","minimum":0,"maximum":100},"taxes":{"type":"integer","minimum":0,"maximum":100},"costs":{"type":"integer","minimum":0,"maximum":100},"net_revenue":{"type":"integer","minimum":0,"maximum":100}}},"MappingSampleTotals":{"type":"object","propertyNames":{"pattern":"^[A-Z]{3}$"},"maxProperties":180,"additionalProperties":{"$ref":"#/components/schemas/MappingSampleCurrencyTotals"}},"MappingSampleCoverage":{"type":"object","propertyNames":{"pattern":"^[A-Z]{3}$"},"maxProperties":180,"additionalProperties":{"$ref":"#/components/schemas/MappingSampleCurrencyCoverage"}},"MappingSampleReconciliation":{"type":"object","additionalProperties":false,"required":["scope","complete_file","currency_basis","sampled_rows","covered_rows","unreconciled_rows","source_totals","mapped_totals","rejected_totals","differences","coverage_rows","balanced"],"properties":{"scope":{"type":"string","const":"profile_sample"},"complete_file":{"type":"boolean","const":false},"currency_basis":{"type":"string","const":"reported_currency_then_settlement_currency"},"sampled_rows":{"type":"integer","minimum":0,"maximum":100},"covered_rows":{"type":"integer","minimum":0,"maximum":100},"unreconciled_rows":{"type":"integer","minimum":0,"maximum":100},"source_totals":{"$ref":"#/components/schemas/MappingSampleTotals"},"mapped_totals":{"$ref":"#/components/schemas/MappingSampleTotals"},"rejected_totals":{"$ref":"#/components/schemas/MappingSampleTotals"},"differences":{"$ref":"#/components/schemas/MappingSampleTotals"},"coverage_rows":{"$ref":"#/components/schemas/MappingSampleCoverage"},"balanced":{"type":"boolean"}}},"MappingPreviewResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["import","profile","selection","mapping","coverage","preview"],"properties":{"import":{"$ref":"#/components/schemas/ImportRecord"},"profile":{"$ref":"#/components/schemas/MappingReviewProfile"},"selection":{"$ref":"#/components/schemas/SourceProfileSelection"},"mapping":{"$ref":"#/components/schemas/MappingDefinition"},"coverage":{"$ref":"#/components/schemas/MappingCoverage"},"preview":{"$ref":"#/components/schemas/MappingPreviewResult"}}}}},"MappingApprovalResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["import","mapping","preview"],"properties":{"import":{"$ref":"#/components/schemas/ImportRecord"},"mapping":{"$ref":"#/components/schemas/ImportMapping"},"preview":{"$ref":"#/components/schemas/MappingPreviewResult"}}}}},"RejectMappingProposalRequest":{"type":"object","additionalProperties":false,"required":["reason"],"properties":{"reason":{"type":"string","minLength":1,"maxLength":500}}},"MappingProposal":{"type":"object","additionalProperties":false,"required":["ref","version","status","profile","mapping","proposed_by","proposed_at","decided_by","decided_at","decision_reason"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"version":{"type":"integer","minimum":1},"status":{"type":"string","enum":["pending","approved","rejected"]},"profile":{"$ref":"#/components/schemas/SourceProfileSelection"},"mapping":{"$ref":"#/components/schemas/MappingDefinition"},"proposed_by":{"$ref":"#/components/schemas/Uuid"},"proposed_at":{"$ref":"#/components/schemas/IsoDateTime"},"decided_by":{"$ref":"#/components/schemas/NullableUuid"},"decided_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"decision_reason":{"type":["string","null"],"maxLength":500}}},"MappingProposalPolicyResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["maker_checker_required","proposal"],"properties":{"maker_checker_required":{"type":"boolean"},"proposal":{"oneOf":[{"$ref":"#/components/schemas/MappingProposal"},{"type":"null"}]}}}}},"MappingProposalResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["proposal","replayed"],"properties":{"proposal":{"$ref":"#/components/schemas/MappingProposal"},"replayed":{"type":"boolean"}}}}},"MappingProposalDecisionResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["proposal","replayed"],"properties":{"proposal":{"$ref":"#/components/schemas/MappingProposal"},"approval":{"type":"object","additionalProperties":false,"required":["import","mapping","preview"],"properties":{"import":{"$ref":"#/components/schemas/ImportRecord"},"mapping":{"$ref":"#/components/schemas/ImportMapping"},"preview":{"$ref":"#/components/schemas/MappingPreviewResult"}}},"replayed":{"type":"boolean"}}}}},"ImportProfileResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["import","profiling"],"properties":{"import":{"$ref":"#/components/schemas/ImportRecord"},"profiling":{"type":"object","additionalProperties":false,"required":["ref","status"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"status":{"type":"string","enum":["pending","running","complete","failed","cancelled"]}}}}}}},"ReplayMeta":{"type":"object","additionalProperties":false,"required":["idempotent_replay"],"properties":{"idempotent_replay":{"type":"boolean"}}},"UploadSessionResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/UploadSessionAuthority"},"meta":{"$ref":"#/components/schemas/ReplayMeta"}}},"UploadSessionAuthority":{"type":"object","additionalProperties":false,"required":["upload_session","creation_endpoint","authorization","metadata","expected_bytes","expires_at"],"properties":{"upload_session":{"$ref":"#/components/schemas/Uuid"},"creation_endpoint":{"type":"string","minLength":1,"maxLength":500},"authorization":{"type":"object","additionalProperties":false,"required":["scheme","token"],"properties":{"scheme":{"type":"string","const":"Bearer"},"token":{"type":"string","minLength":1,"maxLength":256}}},"metadata":{"type":"object","additionalProperties":false,"required":["session"],"properties":{"session":{"$ref":"#/components/schemas/Uuid"}}},"expected_bytes":{"type":"integer","minimum":1},"expires_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"TenantRole":{"type":"string","enum":["platform_operator","tenant_owner","finance_approver","royalty_manager","catalog_manager","uploader","analyst","auditor","payee"]},"ErrorDetail":{"type":"object","additionalProperties":false,"required":["code","message","correlation"],"properties":{"code":{"type":"string","minLength":1,"maxLength":120},"message":{"type":"string","minLength":1,"maxLength":500},"correlation":{"$ref":"#/components/schemas/Uuid"},"fields":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}},"ErrorResponse":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"$ref":"#/components/schemas/ErrorDetail"}}},"WebhookIngressPayload":{"type":"object","minProperties":1,"maxProperties":256,"additionalProperties":true},"WebhookIngressResult":{"type":"object","additionalProperties":false,"required":["receipt","status"],"properties":{"receipt":{"$ref":"#/components/schemas/Uuid"},"status":{"type":"string","const":"accepted"}}},"WebhookIngressResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/WebhookIngressResult"}}},"LoginRequest":{"type":"object","additionalProperties":false,"required":["email","password","tenant"],"properties":{"email":{"type":"string","format":"email","maxLength":254},"password":{"type":"string","maxLength":128},"tenant":{"$ref":"#/components/schemas/Uuid"}}},"AcceptNewInvitationRequest":{"type":"object","additionalProperties":false,"required":["token","name","password"],"properties":{"token":{"type":"string","maxLength":128},"name":{"type":"string","maxLength":160},"password":{"type":"string","minLength":14,"maxLength":128}}},"AcceptExistingInvitationRequest":{"type":"object","additionalProperties":false,"required":["token"],"properties":{"token":{"type":"string","maxLength":128}}},"StartMfaEnrollmentRequest":{"type":"object","additionalProperties":false,"required":["label"],"properties":{"label":{"type":"string","maxLength":120}}},"VerifyMfaRequest":{"type":"object","additionalProperties":false,"required":["factor","code"],"properties":{"factor":{"$ref":"#/components/schemas/Uuid"},"code":{"type":"string","pattern":"^\\d{6}$"}}},"RecoverMfaRequest":{"type":"object","additionalProperties":false,"required":["factor","recovery_code"],"properties":{"factor":{"$ref":"#/components/schemas/Uuid"},"recovery_code":{"type":"string","maxLength":64}}},"PlatformSession":{"type":"object","additionalProperties":false,"required":["identity","tenant","role","mfa_required","mfa_verified","mfa_method","mfa_factor","mfa_factor_type"],"properties":{"identity":{"$ref":"#/components/schemas/Uuid"},"tenant":{"$ref":"#/components/schemas/Uuid"},"role":{"$ref":"#/components/schemas/TenantRole"},"mfa_required":{"type":"boolean"},"mfa_verified":{"type":"boolean"},"mfa_method":{"type":["string","null"],"enum":["totp","recovery",null]},"mfa_factor":{"$ref":"#/components/schemas/NullableUuid"},"mfa_factor_type":{"type":["string","null"],"enum":["totp",null]}}},"PlatformSessionResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PlatformSession"}}},"RevokeIdentitySessionRequest":{"type":"object","additionalProperties":false,"required":["reason"],"properties":{"reason":{"type":"string","minLength":8,"maxLength":500}}},"IdentitySession":{"type":"object","additionalProperties":false,"required":["session","current","status","device_class","device_label","established_at","last_seen_at","mfa_verified_at","ended_at","revoked_at"],"properties":{"session":{"$ref":"#/components/schemas/Uuid"},"current":{"type":"boolean"},"status":{"type":"string","enum":["active","ended","revoked"]},"device_class":{"type":"string","enum":["desktop","mobile","tablet","unknown"]},"device_label":{"type":"string","minLength":1,"maxLength":120},"established_at":{"$ref":"#/components/schemas/IsoDateTime"},"last_seen_at":{"$ref":"#/components/schemas/IsoDateTime"},"mfa_verified_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"ended_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"revoked_at":{"$ref":"#/components/schemas/NullableIsoDateTime"}}},"IdentitySessionPageResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"array","maxItems":50,"items":{"$ref":"#/components/schemas/IdentitySession"}}}},"IdentitySessionRevocation":{"type":"object","additionalProperties":false,"required":["session","status","revoked_at"],"properties":{"session":{"$ref":"#/components/schemas/Uuid"},"status":{"type":"string","const":"revoked"},"revoked_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"IdentitySessionRevocationResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/IdentitySessionRevocation"}}},"InvitationAcceptance":{"type":"object","additionalProperties":false,"required":["tenant","role","status"],"properties":{"tenant":{"$ref":"#/components/schemas/Uuid"},"role":{"$ref":"#/components/schemas/TenantRole"},"status":{"type":"string","enum":["active"]}}},"InvitationAcceptanceResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/InvitationAcceptance"}}},"MfaEnrollment":{"type":"object","additionalProperties":false,"required":["factor","type","secret","provisioning_uri"],"properties":{"factor":{"$ref":"#/components/schemas/Uuid"},"type":{"type":"string","enum":["totp"]},"secret":{"type":"string","minLength":16,"maxLength":128},"provisioning_uri":{"type":"string","format":"uri","maxLength":2048}}},"MfaEnrollmentResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MfaEnrollment"}}},"MfaConfirmation":{"type":"object","additionalProperties":false,"required":["factor","recovery_codes","mfa_verified"],"properties":{"factor":{"$ref":"#/components/schemas/Uuid"},"recovery_codes":{"type":"array","minItems":1,"items":{"type":"string","minLength":1,"maxLength":64}},"mfa_verified":{"type":"boolean"}}},"MfaConfirmationResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MfaConfirmation"}}},"OAuthTokenRequest":{"type":"object","additionalProperties":false,"required":["grant_type"],"properties":{"grant_type":{"type":"string","const":"client_credentials"},"scope":{"type":["string","null"],"maxLength":1000}}},"OAuthTokenResponse":{"type":"object","additionalProperties":false,"required":["access_token","token_type","expires_in","scope"],"properties":{"access_token":{"type":"string","minLength":32,"maxLength":128},"token_type":{"type":"string","const":"Bearer"},"expires_in":{"type":"integer","minimum":0,"maximum":3600},"scope":{"type":"string","maxLength":1000}}},"ApiSession":{"type":"object","additionalProperties":false,"required":["client","tenant","scopes","expires_at"],"properties":{"client":{"$ref":"#/components/schemas/Uuid"},"tenant":{"$ref":"#/components/schemas/Uuid"},"scopes":{"type":"array","items":{"$ref":"#/components/schemas/Scope"}},"expires_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"ApiSessionResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ApiSession"}}},"CreateApiClientRequest":{"type":"object","additionalProperties":false,"required":["name","scopes"],"properties":{"name":{"type":"string","maxLength":160},"scopes":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"$ref":"#/components/schemas/Scope"}},"expires_at":{"$ref":"#/components/schemas/NullableIsoDateTime"}}},"UpdateApiClientRequest":{"type":"object","additionalProperties":false,"required":["name","expires_at"],"properties":{"name":{"type":"string","maxLength":160},"expires_at":{"$ref":"#/components/schemas/NullableIsoDateTime"}}},"RotateApiClientRequest":{"type":"object","additionalProperties":false,"properties":{"overlap_seconds":{"type":"integer","minimum":60,"maximum":86400,"default":300}}},"ReplaceApiClientScopesRequest":{"type":"object","additionalProperties":false,"required":["scopes"],"properties":{"scopes":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"$ref":"#/components/schemas/Scope"}}}},"ManagedApiClient":{"type":"object","additionalProperties":false,"required":["client","name","scopes","status","expires_at","replayed"],"properties":{"client":{"$ref":"#/components/schemas/Uuid"},"name":{"type":"string","maxLength":160},"scopes":{"type":"array","items":{"$ref":"#/components/schemas/Scope"}},"status":{"type":"string","enum":["active","disabled","revoked"]},"expires_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"replayed":{"type":"boolean"},"secret":{"type":"string","minLength":32,"maxLength":128}}},"ManagedApiClientResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ManagedApiClient"}}},"ApiClientInventoryItem":{"type":"object","additionalProperties":false,"required":["client","name","secret_prefix","scopes","status","expires_at","last_used_at","rotated_at","secret_version"],"properties":{"client":{"$ref":"#/components/schemas/Uuid"},"name":{"type":"string","maxLength":160},"secret_prefix":{"type":"string","minLength":1,"maxLength":16},"scopes":{"type":"array","items":{"$ref":"#/components/schemas/Scope"}},"status":{"type":"string","enum":["active","disabled","revoked"]},"expires_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"last_used_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"rotated_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"secret_version":{"type":"integer","minimum":1}}},"ApiTokenInventoryItem":{"type":"object","additionalProperties":false,"required":["token","token_prefix","scopes","status","expires_at","last_used_at","revoked_at"],"properties":{"token":{"$ref":"#/components/schemas/Uuid"},"token_prefix":{"type":"string","minLength":1,"maxLength":16},"scopes":{"type":"array","items":{"$ref":"#/components/schemas/Scope"}},"status":{"type":"string","enum":["active","expired","revoked"]},"expires_at":{"$ref":"#/components/schemas/IsoDateTime"},"last_used_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"revoked_at":{"$ref":"#/components/schemas/NullableIsoDateTime"}}},"CursorMeta":{"type":"object","additionalProperties":false,"required":["next_cursor"],"properties":{"next_cursor":{"$ref":"#/components/schemas/NullableUuid"}}},"ApiClientPage":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ApiClientInventoryItem"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}}},"ApiTokenPage":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ApiTokenInventoryItem"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}}},"CatalogReviewStateValue":{"type":"string","enum":["unreviewed","held","released"]},"CatalogEntitySummary":{"type":"object","additionalProperties":false,"required":["entity","entity_type","snapshot","version","display_name","identifier_count","effective_from","effective_to","recorded_at"],"properties":{"entity":{"$ref":"#/components/schemas/Uuid"},"entity_type":{"type":"string","enum":["recording","release","work","party"]},"snapshot":{"$ref":"#/components/schemas/Uuid"},"version":{"type":"integer","minimum":1},"display_name":{"type":"string","minLength":1,"maxLength":240},"identifier_count":{"type":"integer","minimum":1},"effective_from":{"type":"string","format":"date"},"effective_to":{"type":["string","null"],"format":"date"},"recorded_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"CatalogEntityPage":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CatalogEntitySummary"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}}},"CatalogEntityIdentifier":{"type":"object","additionalProperties":false,"required":["identifier","namespace","value","issuer"],"properties":{"identifier":{"$ref":"#/components/schemas/Uuid"},"namespace":{"type":"string","enum":["isrc","iswc","gtin","catalog_number","dsp_asset","ddex_party","society_party","tenant_ref","connector_ref"]},"value":{"type":"string","minLength":1,"maxLength":320},"issuer":{"type":["string","null"],"maxLength":160}}},"CatalogEntityDetail":{"type":"object","additionalProperties":false,"required":["entity","entity_type","snapshot","version","source","source_reference","effective_from","effective_to","recorded_at","metadata","identifiers"],"properties":{"entity":{"$ref":"#/components/schemas/Uuid"},"entity_type":{"type":"string","enum":["recording","release","work","party"]},"snapshot":{"$ref":"#/components/schemas/Uuid"},"version":{"type":"integer","minimum":1},"source":{"type":"string","maxLength":80},"source_reference":{"type":"string","maxLength":160},"effective_from":{"type":"string","format":"date"},"effective_to":{"type":["string","null"],"format":"date"},"recorded_at":{"$ref":"#/components/schemas/IsoDateTime"},"metadata":{"type":"object","additionalProperties":true},"identifiers":{"type":"array","minItems":1,"maxItems":100,"items":{"$ref":"#/components/schemas/CatalogEntityIdentifier"}}}},"CatalogEntityDetailResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/CatalogEntityDetail"}}},"CatalogDecisionOutcome":{"type":"string","enum":["approved","rejected","unmatched"]},"CatalogDecisionReason":{"type":"string","enum":["verified_exact","reviewed_metadata","conflicting_evidence","insufficient_evidence","no_match"]},"CatalogDecisionSummary":{"type":"object","additionalProperties":false,"required":["decision","candidate","version","outcome","reason_code","reviewed_at"],"properties":{"decision":{"$ref":"#/components/schemas/Uuid"},"candidate":{"$ref":"#/components/schemas/NullableUuid"},"version":{"type":"integer","minimum":1},"outcome":{"$ref":"#/components/schemas/CatalogDecisionOutcome"},"reason_code":{"$ref":"#/components/schemas/CatalogDecisionReason"},"reviewed_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"CatalogBestCandidate":{"type":"object","additionalProperties":false,"required":["candidate","method","confidence","entity","snapshot"],"properties":{"candidate":{"$ref":"#/components/schemas/Uuid"},"method":{"type":"string","enum":["exact_identifier","approved_crosswalk","metadata_suggestion"]},"confidence":{"type":"string","pattern":"^(?:0\\.[0-9]{6}|1\\.0{6})$"},"entity":{"$ref":"#/components/schemas/Uuid"},"snapshot":{"$ref":"#/components/schemas/Uuid"},"ranking":{"$ref":"#/components/schemas/CatalogCandidateRanking"}}},"CatalogReviewItem":{"type":"object","additionalProperties":false,"required":["case","source","source_reference","entity_type","state","candidate_count","created_at"],"properties":{"case":{"$ref":"#/components/schemas/Uuid"},"source":{"type":"string","maxLength":80},"source_reference":{"type":"string","maxLength":160},"entity_type":{"type":"string","enum":["recording","release","work","party"]},"state":{"$ref":"#/components/schemas/CatalogReviewStateValue"},"latest_decision":{"$ref":"#/components/schemas/CatalogDecisionSummary"},"candidate_count":{"type":"integer","minimum":0},"best_candidate":{"$ref":"#/components/schemas/CatalogBestCandidate"},"created_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"CatalogReviewPage":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CatalogReviewItem"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}}},"CatalogReviewStateMetrics":{"type":"object","additionalProperties":false,"required":["total","unreviewed","held","released"],"properties":{"total":{"type":"integer","minimum":0},"unreviewed":{"type":"integer","minimum":0},"held":{"type":"integer","minimum":0},"released":{"type":"integer","minimum":0}}},"CatalogSuspenseMetrics":{"type":"object","additionalProperties":false,"required":["total","unreviewed","rejected","unmatched"],"properties":{"total":{"type":"integer","minimum":0},"unreviewed":{"type":"integer","minimum":0},"rejected":{"type":"integer","minimum":0},"unmatched":{"type":"integer","minimum":0}}},"CatalogCandidateMetrics":{"type":"object","additionalProperties":false,"required":["total","approved_crosswalk","exact_identifier","metadata_suggestion"],"properties":{"total":{"type":"integer","minimum":0},"approved_crosswalk":{"type":"integer","minimum":0},"exact_identifier":{"type":"integer","minimum":0},"metadata_suggestion":{"type":"integer","minimum":0}}},"CatalogQueueAgeMetrics":{"type":"object","additionalProperties":false,"required":["oldest_unreviewed_at","over_24_hours","over_7_days"],"properties":{"oldest_unreviewed_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"over_24_hours":{"type":"integer","minimum":0},"over_7_days":{"type":"integer","minimum":0}}},"CatalogReviewMetrics":{"type":"object","additionalProperties":false,"required":["cases","suspense","exact_approval_ready","candidates","queue_age"],"properties":{"cases":{"$ref":"#/components/schemas/CatalogReviewStateMetrics"},"suspense":{"$ref":"#/components/schemas/CatalogSuspenseMetrics"},"exact_approval_ready":{"type":"integer","minimum":0},"candidates":{"$ref":"#/components/schemas/CatalogCandidateMetrics"},"queue_age":{"$ref":"#/components/schemas/CatalogQueueAgeMetrics"}}},"CatalogReviewMetricsResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/CatalogReviewMetrics"}}},"CatalogMatchDetail":{"type":"object","additionalProperties":false,"required":["case","source","source_reference","entity_type","evidence","state","candidate_count","created_at"],"properties":{"case":{"$ref":"#/components/schemas/Uuid"},"source":{"type":"string","maxLength":80},"source_reference":{"type":"string","maxLength":160},"entity_type":{"type":"string","enum":["recording","release","work","party"]},"evidence":{"type":"object","additionalProperties":true},"state":{"$ref":"#/components/schemas/CatalogReviewStateValue"},"latest_decision":{"$ref":"#/components/schemas/CatalogDecisionSummary"},"candidate_count":{"type":"integer","minimum":0},"related_disputes":{"type":"array","items":{"$ref":"#/components/schemas/CatalogLinkedDispute"}},"created_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"CatalogMatchDetailResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/CatalogMatchDetail"}}},"CatalogCandidateItem":{"type":"object","additionalProperties":false,"required":["candidate","method","confidence","evidence","entity","snapshot","metadata","effective_from","effective_to","created_at"],"properties":{"candidate":{"$ref":"#/components/schemas/Uuid"},"method":{"type":"string","enum":["exact_identifier","approved_crosswalk","metadata_suggestion"]},"confidence":{"type":"string","pattern":"^(?:0\\.[0-9]{6}|1\\.0{6})$"},"ranking":{"$ref":"#/components/schemas/CatalogCandidateRanking"},"evidence":{"type":"object","additionalProperties":true},"entity":{"$ref":"#/components/schemas/Uuid"},"snapshot":{"$ref":"#/components/schemas/Uuid"},"metadata":{"type":"object","additionalProperties":true},"comparison":{"type":"array","maxItems":50,"items":{"$ref":"#/components/schemas/CatalogCandidateComparison"}},"effective_from":{"type":"string","format":"date"},"effective_to":{"type":["string","null"],"format":"date"},"created_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"CatalogCandidatePage":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CatalogCandidateItem"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}}},"CatalogDecisionRequest":{"type":"object","additionalProperties":false,"required":["outcome","reason_code"],"properties":{"candidate":{"$ref":"#/components/schemas/NullableUuid"},"outcome":{"$ref":"#/components/schemas/CatalogDecisionOutcome"},"reason_code":{"$ref":"#/components/schemas/CatalogDecisionReason"}}},"CatalogDecisionResult":{"type":"object","additionalProperties":false,"required":["case","decision","candidate","outcome","reason_code","accounting_state","replayed"],"properties":{"case":{"$ref":"#/components/schemas/Uuid"},"decision":{"$ref":"#/components/schemas/Uuid"},"candidate":{"$ref":"#/components/schemas/NullableUuid"},"outcome":{"$ref":"#/components/schemas/CatalogDecisionOutcome"},"reason_code":{"$ref":"#/components/schemas/CatalogDecisionReason"},"accounting_state":{"type":"string","enum":["held","released"]},"replayed":{"type":"boolean"}}},"CatalogDecisionResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/CatalogDecisionResult"}}},"CatalogLinkedDispute":{"type":"object","additionalProperties":false,"required":["link","dispute","category","reason","response_due_on","linked_at"],"properties":{"link":{"$ref":"#/components/schemas/Uuid"},"dispute":{"$ref":"#/components/schemas/Uuid"},"category":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"reason":{"type":"string","minLength":1,"maxLength":500},"response_due_on":{"type":"string","format":"date"},"linked_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"CatalogDisputeLinkRequest":{"type":"object","additionalProperties":false,"required":["dispute","reason"],"properties":{"dispute":{"$ref":"#/components/schemas/Uuid"},"reason":{"type":"string","minLength":1,"maxLength":500}}},"CatalogDisputeLinkResult":{"type":"object","additionalProperties":false,"required":["case","dispute","link","replayed"],"properties":{"case":{"$ref":"#/components/schemas/Uuid"},"dispute":{"$ref":"#/components/schemas/Uuid"},"link":{"$ref":"#/components/schemas/Uuid"},"replayed":{"type":"boolean"}}},"CatalogDisputeLinkResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/CatalogDisputeLinkResult"}}},"CatalogCandidateRanking":{"type":"object","additionalProperties":false,"required":["method_priority","confidence_order","tie_breaker"],"properties":{"method_priority":{"type":"integer","minimum":1,"maximum":3},"confidence_order":{"type":"string","const":"descending"},"tie_breaker":{"type":"string","const":"stable_candidate_reference"}}},"CatalogCandidateComparison":{"type":"object","additionalProperties":false,"required":["field","status"],"properties":{"field":{"type":"string","minLength":1,"maxLength":160},"status":{"type":"string","enum":["exact","normalized","different"]}}},"AnomalyCaseStatus":{"type":"string","enum":["open","triaged","investigating","resolution_pending","resolved","accepted_risk","suppressed"]},"AnomalyHoldStatus":{"type":"string","enum":["none","active","released"]},"AnomalyClass":{"type":"string","enum":["file_schema","reconciliation","catalog_rights","rate_market","contract_allocation","ledger_statement","payout_identity","operational"]},"AnomalySeverity":{"type":"string","enum":["info","warning","error","critical"]},"AnomalyConsequence":{"type":"string","enum":["observe","review","block"]},"AnomalyComment":{"type":"object","additionalProperties":false,"required":["comment_ref","actor_ref","actor_role","body","commented_at"],"properties":{"comment_ref":{"$ref":"#/components/schemas/Uuid"},"actor_ref":{"$ref":"#/components/schemas/Uuid"},"actor_role":{"type":"string","enum":["platform_operator","tenant_owner","finance_approver","royalty_manager","analyst"]},"body":{"type":"string","minLength":1,"maxLength":2000},"commented_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"AnomalyCaseItem":{"type":"object","additionalProperties":false,"required":["case_ref","finding_ref","status","hold_status","assigned_to","version","class","severity","consequence","rule_code","rule_version","source_type","source_ref","subject_type","subject_ref","explanation","detected_at","opened_at","suppression_expires_at"],"properties":{"case_ref":{"$ref":"#/components/schemas/Uuid"},"finding_ref":{"$ref":"#/components/schemas/Uuid"},"status":{"$ref":"#/components/schemas/AnomalyCaseStatus"},"hold_status":{"$ref":"#/components/schemas/AnomalyHoldStatus"},"assigned_to":{"$ref":"#/components/schemas/NullableUuid"},"version":{"type":"integer","minimum":1},"class":{"$ref":"#/components/schemas/AnomalyClass"},"severity":{"$ref":"#/components/schemas/AnomalySeverity"},"consequence":{"$ref":"#/components/schemas/AnomalyConsequence"},"rule_code":{"type":"string","minLength":3,"maxLength":120},"rule_version":{"type":"string","minLength":1,"maxLength":64},"source_type":{"type":"string","minLength":2,"maxLength":80},"source_ref":{"$ref":"#/components/schemas/Uuid"},"subject_type":{"type":"string","minLength":2,"maxLength":80},"subject_ref":{"$ref":"#/components/schemas/Uuid"},"explanation":{"type":"string","minLength":1,"maxLength":1000},"detected_at":{"$ref":"#/components/schemas/IsoDateTime"},"opened_at":{"$ref":"#/components/schemas/IsoDateTime"},"suppression_expires_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"comments":{"type":"array","maxItems":10000,"items":{"$ref":"#/components/schemas/AnomalyComment"}},"comments_truncated":{"type":"boolean"}}},"AnomalyCasePage":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/AnomalyCaseItem"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}}},"AnomalyCaseDetailResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/AnomalyCaseItem"}}},"AnomalyCommentRequest":{"type":"object","additionalProperties":false,"required":["body"],"properties":{"body":{"type":"string","minLength":1,"maxLength":2000}}},"AnomalyCountMap":{"type":"object","additionalProperties":{"type":"integer","minimum":0}},"AnomalyMetrics":{"type":"object","additionalProperties":false,"required":["cases_by_status","cases_by_hold","findings_by_class","findings_by_severity","active_cases","oldest_active_at","expired_suppressions","observed_at"],"properties":{"cases_by_status":{"$ref":"#/components/schemas/AnomalyCountMap"},"cases_by_hold":{"$ref":"#/components/schemas/AnomalyCountMap"},"findings_by_class":{"$ref":"#/components/schemas/AnomalyCountMap"},"findings_by_severity":{"$ref":"#/components/schemas/AnomalyCountMap"},"active_cases":{"type":"integer","minimum":0},"oldest_active_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"expired_suppressions":{"type":"integer","minimum":0},"observed_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"AnomalyMetricsResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/AnomalyMetrics"}}},"AnomalyCommentResult":{"type":"object","additionalProperties":false,"required":["case","comment","body","commented_at"],"properties":{"case":{"$ref":"#/components/schemas/Uuid"},"comment":{"$ref":"#/components/schemas/Uuid"},"body":{"type":"string","minLength":1,"maxLength":2000},"commented_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"AnomalyCommentResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/AnomalyCommentResult"}}},"CatalogBulkExactDecisionRequest":{"type":"object","additionalProperties":false,"required":["items"],"properties":{"items":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["case","candidate"],"properties":{"case":{"$ref":"#/components/schemas/Uuid"},"candidate":{"$ref":"#/components/schemas/Uuid"}}}}}},"CatalogBulkExactDecisionItem":{"type":"object","additionalProperties":false,"required":["case","candidate","decision","accounting_state"],"properties":{"case":{"$ref":"#/components/schemas/Uuid"},"candidate":{"$ref":"#/components/schemas/Uuid"},"decision":{"$ref":"#/components/schemas/Uuid"},"accounting_state":{"type":"string","const":"released"}}},"CatalogBulkExactDecisionResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"type":"object","additionalProperties":false,"required":["items","replayed"],"properties":{"items":{"type":"array","minItems":1,"maxItems":20,"items":{"$ref":"#/components/schemas/CatalogBulkExactDecisionItem"}},"replayed":{"type":"boolean"}}}}},"PayoutExceptionSummary":{"type":"object","additionalProperties":false,"required":["case","command","exception_type","state","queue_status","attempts","max_attempts","error_code","opened_at","lookup_recheck_allowed"],"properties":{"case":{"$ref":"#/components/schemas/Uuid"},"command":{"$ref":"#/components/schemas/Uuid"},"exception_type":{"type":"string","enum":["ambiguous","dead_lettered"]},"state":{"type":"string","enum":["open","resolved"]},"queue_status":{"type":"string","enum":["pending","processing","ambiguous","submitted","failed","dead_lettered"]},"attempts":{"type":"integer","minimum":0,"maximum":50},"max_attempts":{"type":"integer","minimum":1,"maximum":50},"error_code":{"type":"string","pattern":"^[a-z][a-z0-9._:-]{1,119}$"},"opened_at":{"$ref":"#/components/schemas/IsoDateTime"},"lookup_recheck_allowed":{"type":"boolean"}}},"PayoutExceptionPage":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PayoutExceptionSummary"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}}},"PayoutExceptionEvent":{"type":"object","additionalProperties":false,"required":["event","sequence","type","finding","reason","role","occurred_at"],"properties":{"event":{"$ref":"#/components/schemas/Uuid"},"sequence":{"type":"integer","minimum":1},"type":{"type":"string","enum":["investigation_recorded","lookup_recheck_requested"]},"finding":{"type":"string","enum":["provider_lookup_required","monitor_only","manual_provider_review","configuration_fault","escalate_provider","lookup_recheck_approved"]},"reason":{"type":"string","minLength":1,"maxLength":1000},"role":{"$ref":"#/components/schemas/TenantRole"},"occurred_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"PayoutExceptionDetail":{"type":"object","additionalProperties":false,"required":["case","command","exception_type","state","queue_status","attempts","max_attempts","error_code","opened_at","lookup_recheck_allowed","events"],"properties":{"case":{"$ref":"#/components/schemas/Uuid"},"command":{"$ref":"#/components/schemas/Uuid"},"exception_type":{"type":"string","enum":["ambiguous","dead_lettered"]},"state":{"type":"string","enum":["open","resolved"]},"queue_status":{"type":"string","enum":["pending","processing","ambiguous","submitted","failed","dead_lettered"]},"attempts":{"type":"integer","minimum":0,"maximum":50},"max_attempts":{"type":"integer","minimum":1,"maximum":50},"error_code":{"type":"string","pattern":"^[a-z][a-z0-9._:-]{1,119}$"},"opened_at":{"$ref":"#/components/schemas/IsoDateTime"},"lookup_recheck_allowed":{"type":"boolean"},"events":{"type":"array","items":{"$ref":"#/components/schemas/PayoutExceptionEvent"}}}},"PayoutExceptionDetailResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PayoutExceptionDetail"}}},"InvestigatePayoutExceptionRequest":{"type":"object","additionalProperties":false,"required":["finding","reason"],"properties":{"finding":{"type":"string","enum":["provider_lookup_required","monitor_only","manual_provider_review","configuration_fault","escalate_provider"]},"reason":{"type":"string","minLength":1,"maxLength":1000}}},"RecheckPayoutExceptionRequest":{"type":"object","additionalProperties":false,"required":["reason"],"properties":{"reason":{"type":"string","minLength":1,"maxLength":1000}}},"PayoutExceptionEventResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PayoutExceptionEvent"}}},"PayoutLookupRecheck":{"type":"object","additionalProperties":false,"required":["event","sequence","type","finding","reason","role","occurred_at","queue_status","next_action"],"properties":{"event":{"$ref":"#/components/schemas/Uuid"},"sequence":{"type":"integer","minimum":1},"type":{"type":"string","const":"lookup_recheck_requested"},"finding":{"type":"string","const":"lookup_recheck_approved"},"reason":{"type":"string","minLength":1,"maxLength":1000},"role":{"$ref":"#/components/schemas/TenantRole"},"occurred_at":{"$ref":"#/components/schemas/IsoDateTime"},"queue_status":{"type":"string","const":"ambiguous"},"next_action":{"type":"string","const":"provider_lookup"}}},"PayoutLookupRecheckResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PayoutLookupRecheck"}}},"PayoutAlertRoute":{"type":"object","additionalProperties":false,"required":["ref","channel","destination_ref","minimum_severity","effective_at","expires_at","status","approved_by","reviewed_by","retired_by","retired_at"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"channel":{"type":"string","enum":["pagerduty","email_group","webhook"]},"destination_ref":{"$ref":"#/components/schemas/Uuid"},"minimum_severity":{"type":"string","enum":["degraded","critical"]},"effective_at":{"$ref":"#/components/schemas/IsoDateTime"},"expires_at":{"oneOf":[{"$ref":"#/components/schemas/IsoDateTime"},{"type":"null"}]},"status":{"type":"string","enum":["active","retired"]},"approved_by":{"$ref":"#/components/schemas/Uuid"},"reviewed_by":{"$ref":"#/components/schemas/Uuid"},"retired_by":{"$ref":"#/components/schemas/NullableUuid"},"retired_at":{"oneOf":[{"$ref":"#/components/schemas/IsoDateTime"},{"type":"null"}]}}},"PayoutAlertRouteResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PayoutAlertRoute"}}},"PayoutAlertRoutePage":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PayoutAlertRoute"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}}},"PayoutAlertRouteProposal":{"type":"object","additionalProperties":false,"required":["ref","status","channel","destination_ref","minimum_severity","effective_at","expires_at","proposed_by","proposed_at","decided_by","decided_at","decision_reason"],"properties":{"ref":{"$ref":"#/components/schemas/Uuid"},"status":{"type":"string","enum":["pending","approved","rejected"]},"channel":{"type":"string","enum":["pagerduty","email_group","webhook"]},"destination_ref":{"$ref":"#/components/schemas/Uuid"},"minimum_severity":{"type":"string","enum":["degraded","critical"]},"effective_at":{"$ref":"#/components/schemas/IsoDateTime"},"expires_at":{"oneOf":[{"$ref":"#/components/schemas/IsoDateTime"},{"type":"null"}]},"proposed_by":{"$ref":"#/components/schemas/Uuid"},"proposed_at":{"$ref":"#/components/schemas/IsoDateTime"},"decided_by":{"$ref":"#/components/schemas/NullableUuid"},"decided_at":{"oneOf":[{"$ref":"#/components/schemas/IsoDateTime"},{"type":"null"}]},"decision_reason":{"type":["string","null"],"minLength":8,"maxLength":500}}},"PayoutAlertRouteProposalResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PayoutAlertRouteProposal"}}},"PayoutAlertRouteProposalPage":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PayoutAlertRouteProposal"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}}},"ProposePayoutAlertRouteRequest":{"type":"object","additionalProperties":false,"required":["channel","destination_ref","minimum_severity","effective_at"],"properties":{"channel":{"type":"string","enum":["pagerduty","email_group","webhook"]},"destination_ref":{"$ref":"#/components/schemas/Uuid"},"minimum_severity":{"type":"string","enum":["degraded","critical"]},"effective_at":{"$ref":"#/components/schemas/IsoDateTime"},"expires_at":{"oneOf":[{"$ref":"#/components/schemas/IsoDateTime"},{"type":"null"}]}}},"RejectPayoutAlertRouteProposalRequest":{"type":"object","additionalProperties":false,"required":["reason"],"properties":{"reason":{"type":"string","minLength":8,"maxLength":500}}},"PayoutAlertRouteProposalCommandResult":{"type":"object","additionalProperties":false,"required":["proposal","replayed"],"properties":{"proposal":{"$ref":"#/components/schemas/PayoutAlertRouteProposal"},"replayed":{"type":"boolean"}}},"PayoutAlertRouteProposalCommandResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PayoutAlertRouteProposalCommandResult"}}},"PayoutAlertRouteApprovalResult":{"type":"object","additionalProperties":false,"required":["proposal","route","replayed"],"properties":{"proposal":{"$ref":"#/components/schemas/PayoutAlertRouteProposal"},"route":{"$ref":"#/components/schemas/PayoutAlertRoute"},"replayed":{"type":"boolean"}}},"PayoutAlertRouteApprovalResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PayoutAlertRouteApprovalResult"}}},"MoneyString":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,25})(?:\\.[0-9]{1,12})?$"},"DisputeStateValue":{"type":"string","enum":["open","rejected","withdrawn","upheld"]},"DisputeSummary":{"type":"object","additionalProperties":false,"required":["dispute","statement","amount","currency","category","state","submitted_on","response_due_on","submitted_at","evidence_item_count","evidence_total_bytes"],"properties":{"dispute":{"$ref":"#/components/schemas/Uuid"},"statement":{"$ref":"#/components/schemas/Uuid"},"amount":{"$ref":"#/components/schemas/MoneyString"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"category":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"state":{"$ref":"#/components/schemas/DisputeStateValue"},"submitted_on":{"type":"string","format":"date"},"response_due_on":{"type":"string","format":"date"},"submitted_at":{"$ref":"#/components/schemas/IsoDateTime"},"evidence_item_count":{"type":"integer","minimum":1,"maximum":20},"evidence_total_bytes":{"type":"integer","minimum":1,"maximum":524288000}}},"DisputePage":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DisputeSummary"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}}},"DisputeEvidenceItem":{"type":"object","additionalProperties":false,"required":["item","sequence","label","bytes","media_type"],"properties":{"item":{"$ref":"#/components/schemas/Uuid"},"sequence":{"type":"integer","minimum":1,"maximum":20},"label":{"type":"string","minLength":1,"maxLength":160},"bytes":{"type":"integer","minimum":1,"maximum":52428800},"media_type":{"type":"string","maxLength":255}}},"GrantedDisputeEvidenceAccess":{"type":"object","additionalProperties":false,"required":["access","expires_at","download_url"],"properties":{"access":{"$ref":"#/components/schemas/Uuid"},"expires_at":{"$ref":"#/components/schemas/IsoDateTime"},"download_url":{"type":"string","format":"uri","maxLength":4096}}},"GrantedDisputeEvidenceAccessResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/GrantedDisputeEvidenceAccess"}}},"DisputeEvidence":{"type":"object","additionalProperties":false,"required":["manifest","item_count","total_bytes","approved_at","items"],"properties":{"manifest":{"$ref":"#/components/schemas/Uuid"},"item_count":{"type":"integer","minimum":1,"maximum":20},"total_bytes":{"type":"integer","minimum":1,"maximum":524288000},"approved_at":{"$ref":"#/components/schemas/IsoDateTime"},"items":{"type":"array","minItems":1,"maxItems":20,"items":{"$ref":"#/components/schemas/DisputeEvidenceItem"}}}},"DisputeEvent":{"type":"object","additionalProperties":false,"required":["event","sequence","type","occurred_at"],"properties":{"event":{"$ref":"#/components/schemas/Uuid"},"sequence":{"type":"integer","minimum":1},"type":{"type":"string","enum":["submitted","acknowledged","assigned","investigating","proposed","withdrawn","rejected","upheld","escalated","reopened"]},"occurred_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"DisputeOutcome":{"type":"object","additionalProperties":false,"required":["outcome","state","reason","decided_on","decided_at"],"properties":{"outcome":{"$ref":"#/components/schemas/Uuid"},"state":{"type":"string","enum":["rejected","withdrawn","upheld"]},"reason":{"type":"string","minLength":1,"maxLength":1000},"correction":{"$ref":"#/components/schemas/Uuid"},"replacement_statement":{"$ref":"#/components/schemas/Uuid"},"decided_on":{"type":"string","format":"date"},"decided_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"DisputeAcknowledgementSummary":{"type":"object","additionalProperties":false,"required":["acknowledgement","note","acknowledged_at"],"properties":{"acknowledgement":{"$ref":"#/components/schemas/Uuid"},"note":{"type":"string","minLength":1,"maxLength":1000},"acknowledged_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"DisputeAssignment":{"type":"object","additionalProperties":false,"required":["assignment","sequence","assignee","reason","assigned_at"],"properties":{"assignment":{"$ref":"#/components/schemas/Uuid"},"sequence":{"type":"integer","minimum":1},"assignee":{"$ref":"#/components/schemas/Uuid"},"reason":{"type":"string","minLength":1,"maxLength":1000},"assigned_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"DisputeInvestigation":{"type":"object","additionalProperties":false,"required":["investigation","assignment","reason","started_at"],"properties":{"investigation":{"$ref":"#/components/schemas/Uuid"},"assignment":{"$ref":"#/components/schemas/Uuid"},"reason":{"type":"string","minLength":1,"maxLength":1000},"started_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"DisputeProposal":{"type":"object","additionalProperties":false,"required":["proposal","investigation","assignment","recommendation","reason","proposed_at"],"properties":{"proposal":{"$ref":"#/components/schemas/Uuid"},"investigation":{"$ref":"#/components/schemas/Uuid"},"assignment":{"$ref":"#/components/schemas/Uuid"},"recommendation":{"type":"string","enum":["rejected","withdrawn","upheld"]},"reason":{"type":"string","minLength":1,"maxLength":1000},"proposed_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"DisputeEscalation":{"type":"object","additionalProperties":false,"required":["escalation","proposal","assignment","target_role","reason","response_due_on","escalated_at"],"properties":{"escalation":{"$ref":"#/components/schemas/Uuid"},"proposal":{"$ref":"#/components/schemas/Uuid"},"assignment":{"$ref":"#/components/schemas/Uuid"},"target_role":{"type":"string","enum":["finance_approver","tenant_owner"]},"reason":{"type":"string","minLength":1,"maxLength":1000},"response_due_on":{"type":"string","format":"date"},"escalated_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"DisputeNote":{"type":"object","additionalProperties":false,"required":["note","sequence","body","recorded_at"],"properties":{"note":{"$ref":"#/components/schemas/Uuid"},"sequence":{"type":"integer","minimum":1},"body":{"type":"string","minLength":1,"maxLength":4000},"recorded_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"DisputeNotePage":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DisputeNote"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}}},"DisputeDetail":{"type":"object","additionalProperties":false,"required":["dispute","statement","amount","currency","category","state","submitted_on","response_due_on","submitted_at","evidence_item_count","evidence_total_bytes","reason","evidence","events"],"properties":{"dispute":{"$ref":"#/components/schemas/Uuid"},"statement":{"$ref":"#/components/schemas/Uuid"},"amount":{"$ref":"#/components/schemas/MoneyString"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"category":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"state":{"$ref":"#/components/schemas/DisputeStateValue"},"submitted_on":{"type":"string","format":"date"},"response_due_on":{"type":"string","format":"date"},"submitted_at":{"$ref":"#/components/schemas/IsoDateTime"},"evidence_item_count":{"type":"integer","minimum":1,"maximum":20},"evidence_total_bytes":{"type":"integer","minimum":1,"maximum":524288000},"reason":{"type":"string","minLength":1,"maxLength":1000},"evidence":{"$ref":"#/components/schemas/DisputeEvidence"},"events":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/DisputeEvent"}},"outcome":{"$ref":"#/components/schemas/DisputeOutcome"},"acknowledgement":{"$ref":"#/components/schemas/DisputeAcknowledgementSummary"},"assignments":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/DisputeAssignment"}},"current_assignment":{"$ref":"#/components/schemas/DisputeAssignment"},"investigation":{"$ref":"#/components/schemas/DisputeInvestigation"},"proposal":{"$ref":"#/components/schemas/DisputeProposal"},"escalation":{"$ref":"#/components/schemas/DisputeEscalation"}}},"DisputeDetailResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/DisputeDetail"}}},"SubmitDisputeRequest":{"type":"object","additionalProperties":false,"required":["statement","amount","category","reason","evidence_manifest_hash","submitted_on","response_due_on"],"properties":{"statement":{"$ref":"#/components/schemas/Uuid"},"amount":{"$ref":"#/components/schemas/MoneyString"},"category":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"reason":{"type":"string","minLength":1,"maxLength":1000},"evidence_manifest_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"submitted_on":{"type":"string","format":"date"},"response_due_on":{"type":"string","format":"date"}}},"UploadDisputeEvidenceRequest":{"type":"object","additionalProperties":false,"required":["file","media_type","label"],"properties":{"file":{"type":"string","format":"binary"},"media_type":{"type":"string","enum":["application/pdf","image/jpeg","image/png"]},"label":{"type":"string","minLength":1,"maxLength":160}}},"UploadedDisputeEvidence":{"type":"object","additionalProperties":false,"required":["evidence_manifest","evidence_manifest_hash","item_count","total_bytes","media_type"],"properties":{"evidence_manifest":{"$ref":"#/components/schemas/Uuid"},"evidence_manifest_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"item_count":{"type":"integer","const":1},"total_bytes":{"type":"integer","minimum":1,"maximum":52428800},"media_type":{"type":"string","enum":["application/pdf","image/jpeg","image/png"]}}},"UploadedDisputeEvidenceResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/UploadedDisputeEvidence"}}},"AcknowledgeDisputeRequest":{"type":"object","additionalProperties":false,"required":["note"],"properties":{"note":{"type":"string","minLength":1,"maxLength":1000}}},"AcknowledgedDispute":{"type":"object","additionalProperties":false,"required":["dispute","acknowledgement","note","state","acknowledged_at"],"properties":{"dispute":{"$ref":"#/components/schemas/Uuid"},"acknowledgement":{"$ref":"#/components/schemas/Uuid"},"note":{"type":"string","minLength":1,"maxLength":1000},"state":{"type":"string","const":"acknowledged"},"acknowledged_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"AcknowledgedDisputeResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/AcknowledgedDispute"}}},"AssignDisputeRequest":{"type":"object","additionalProperties":false,"required":["assignee","reason"],"properties":{"assignee":{"$ref":"#/components/schemas/Uuid"},"reason":{"type":"string","minLength":1,"maxLength":1000}}},"AssignedDispute":{"type":"object","additionalProperties":false,"required":["dispute","assignment","assignee","sequence","reason","state","assigned_at"],"properties":{"dispute":{"$ref":"#/components/schemas/Uuid"},"assignment":{"$ref":"#/components/schemas/Uuid"},"assignee":{"$ref":"#/components/schemas/Uuid"},"sequence":{"type":"integer","minimum":1},"reason":{"type":"string","minLength":1,"maxLength":1000},"state":{"type":"string","const":"assigned"},"assigned_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"AssignedDisputeResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/AssignedDispute"}}},"InvestigateDisputeRequest":{"type":"object","additionalProperties":false,"required":["reason"],"properties":{"reason":{"type":"string","minLength":1,"maxLength":1000}}},"InvestigatingDispute":{"type":"object","additionalProperties":false,"required":["dispute","investigation","assignment","reason","state","started_at"],"properties":{"dispute":{"$ref":"#/components/schemas/Uuid"},"investigation":{"$ref":"#/components/schemas/Uuid"},"assignment":{"$ref":"#/components/schemas/Uuid"},"reason":{"type":"string","minLength":1,"maxLength":1000},"state":{"type":"string","const":"investigating"},"started_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"InvestigatingDisputeResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/InvestigatingDispute"}}},"ProposeDisputeRequest":{"type":"object","additionalProperties":false,"required":["recommendation","reason"],"properties":{"recommendation":{"type":"string","enum":["rejected","withdrawn","upheld"]},"reason":{"type":"string","minLength":1,"maxLength":1000}}},"ProposedDispute":{"type":"object","additionalProperties":false,"required":["dispute","proposal","investigation","assignment","recommendation","reason","state","proposed_at"],"properties":{"dispute":{"$ref":"#/components/schemas/Uuid"},"proposal":{"$ref":"#/components/schemas/Uuid"},"investigation":{"$ref":"#/components/schemas/Uuid"},"assignment":{"$ref":"#/components/schemas/Uuid"},"recommendation":{"type":"string","enum":["rejected","withdrawn","upheld"]},"reason":{"type":"string","minLength":1,"maxLength":1000},"state":{"type":"string","const":"proposed"},"proposed_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"ProposedDisputeResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ProposedDispute"}}},"EscalateDisputeRequest":{"type":"object","additionalProperties":false,"required":["target_role","reason","response_due_on"],"properties":{"target_role":{"type":"string","enum":["finance_approver","tenant_owner"]},"reason":{"type":"string","minLength":1,"maxLength":1000},"response_due_on":{"type":"string","format":"date"}}},"EscalatedDispute":{"type":"object","additionalProperties":false,"required":["dispute","escalation","proposal","assignment","target_role","reason","response_due_on","state","escalated_at"],"properties":{"dispute":{"$ref":"#/components/schemas/Uuid"},"escalation":{"$ref":"#/components/schemas/Uuid"},"proposal":{"$ref":"#/components/schemas/Uuid"},"assignment":{"$ref":"#/components/schemas/Uuid"},"target_role":{"type":"string","enum":["finance_approver","tenant_owner"]},"reason":{"type":"string","minLength":1,"maxLength":1000},"response_due_on":{"type":"string","format":"date"},"state":{"type":"string","const":"escalated"},"escalated_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"EscalatedDisputeResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/EscalatedDispute"}}},"RecordDisputeNoteRequest":{"type":"object","additionalProperties":false,"required":["body"],"properties":{"body":{"type":"string","minLength":1,"maxLength":4000}}},"RecordedDisputeNote":{"type":"object","additionalProperties":false,"required":["dispute","note","sequence","body","recorded_at"],"properties":{"dispute":{"$ref":"#/components/schemas/Uuid"},"note":{"$ref":"#/components/schemas/Uuid"},"sequence":{"type":"integer","minimum":1},"body":{"type":"string","minLength":1,"maxLength":4000},"recorded_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"RecordedDisputeNoteResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/RecordedDisputeNote"}}},"RecordDisputeCommunicationRequest":{"type":"object","additionalProperties":false,"required":["direction","channel","external_party_ref","external_message_ref","subject","body","occurred_at"],"properties":{"direction":{"type":"string","enum":["inbound","outbound"]},"channel":{"type":"string","enum":["email","letter","phone","portal","other"]},"external_party_ref":{"type":"string","minLength":1,"maxLength":160},"external_message_ref":{"type":"string","pattern":"^[A-Za-z0-9._:@/-]{8,160}$"},"subject":{"type":"string","minLength":1,"maxLength":240},"body":{"type":"string","minLength":1,"maxLength":4000},"occurred_at":{"type":"string","format":"date-time"}}},"RecordedDisputeCommunication":{"type":"object","additionalProperties":false,"required":["dispute","communication","sequence","direction","channel","occurred_at","recorded_at"],"properties":{"dispute":{"$ref":"#/components/schemas/Uuid"},"communication":{"$ref":"#/components/schemas/Uuid"},"sequence":{"type":"integer","minimum":1},"direction":{"type":"string","enum":["inbound","outbound"]},"channel":{"type":"string","enum":["email","letter","phone","portal","other"]},"occurred_at":{"$ref":"#/components/schemas/IsoDateTime"},"recorded_at":{"$ref":"#/components/schemas/IsoDateTime"}}},"RecordedDisputeCommunicationResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/RecordedDisputeCommunication"}}},"ReopenDisputeRequest":{"type":"object","additionalProperties":false,"required":["reason","evidence_manifest_hash","submitted_on","response_due_on"],"properties":{"reason":{"type":"string","minLength":1,"maxLength":1000},"evidence_manifest_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"submitted_on":{"type":"string","format":"date"},"response_due_on":{"type":"string","format":"date"}}},"ReopenedDispute":{"type":"object","additionalProperties":false,"required":["dispute","reopen","child_dispute","state","submitted_on","response_due_on"],"properties":{"dispute":{"$ref":"#/components/schemas/Uuid"},"reopen":{"$ref":"#/components/schemas/Uuid"},"child_dispute":{"$ref":"#/components/schemas/Uuid"},"state":{"type":"string","const":"reopened"},"submitted_on":{"type":"string","format":"date"},"response_due_on":{"type":"string","format":"date"}}},"ReopenedDisputeResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ReopenedDispute"}}},"SubmittedDispute":{"type":"object","additionalProperties":false,"required":["dispute","amount","currency","category","submitted_on","response_due_on","state"],"properties":{"dispute":{"$ref":"#/components/schemas/Uuid"},"amount":{"$ref":"#/components/schemas/MoneyString"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"category":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"},"submitted_on":{"type":"string","format":"date"},"response_due_on":{"type":"string","format":"date"},"state":{"type":"string","const":"submitted"}}},"SubmittedDisputeResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/SubmittedDispute"}}},"ReleaseDisputeRequest":{"type":"object","additionalProperties":false,"required":["disposition","reason","resolved_on"],"properties":{"disposition":{"type":"string","enum":["rejected","withdrawn"]},"reason":{"type":"string","minLength":1,"maxLength":1000},"resolved_on":{"type":"string","format":"date"}}},"ReleasedDispute":{"type":"object","additionalProperties":false,"required":["dispute","resolution","state","resolved_on"],"properties":{"dispute":{"$ref":"#/components/schemas/Uuid"},"resolution":{"$ref":"#/components/schemas/Uuid"},"state":{"type":"string","enum":["rejected","withdrawn"]},"resolved_on":{"type":"string","format":"date"}}},"ReleasedDisputeResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ReleasedDispute"}}},"UpholdDisputeRequest":{"type":"object","additionalProperties":false,"required":["correction","reason","upheld_on"],"properties":{"correction":{"$ref":"#/components/schemas/Uuid"},"reason":{"type":"string","minLength":1,"maxLength":1000},"upheld_on":{"type":"string","format":"date"}}},"UpheldDispute":{"type":"object","additionalProperties":false,"required":["dispute","uphold","correction","state","upheld_on"],"properties":{"dispute":{"$ref":"#/components/schemas/Uuid"},"uphold":{"$ref":"#/components/schemas/Uuid"},"correction":{"$ref":"#/components/schemas/Uuid"},"state":{"type":"string","const":"upheld"},"upheld_on":{"type":"string","format":"date"}}},"UpheldDisputeResponse":{"type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"$ref":"#/components/schemas/UpheldDispute"}}},"PublishedCoverageCount":{"type":"object","additionalProperties":false,"required":["covered_rows","total_rows"],"properties":{"covered_rows":{"type":"integer","minimum":0},"total_rows":{"type":"integer","minimum":0}}},"PublishedAnalyticsTotals":{"type":"object","additionalProperties":false,"required":["units","duration_seconds","gross_revenue","deductions","taxes","costs","net_revenue"],"properties":{"units":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"duration_seconds":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"gross_revenue":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"deductions":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"taxes":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"costs":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"net_revenue":{"$ref":"#/components/schemas/SignedCanonicalDecimal"}}},"PublishedAnalyticsCoverage":{"type":"object","additionalProperties":false,"required":["units","duration_seconds","gross_revenue","deductions","taxes","costs","net_revenue","territory","subscription_plan"],"properties":{"units":{"$ref":"#/components/schemas/PublishedCoverageCount"},"duration_seconds":{"$ref":"#/components/schemas/PublishedCoverageCount"},"gross_revenue":{"$ref":"#/components/schemas/PublishedCoverageCount"},"deductions":{"$ref":"#/components/schemas/PublishedCoverageCount"},"taxes":{"$ref":"#/components/schemas/PublishedCoverageCount"},"costs":{"$ref":"#/components/schemas/PublishedCoverageCount"},"net_revenue":{"$ref":"#/components/schemas/PublishedCoverageCount"},"territory":{"$ref":"#/components/schemas/PublishedCoverageCount"},"subscription_plan":{"$ref":"#/components/schemas/PublishedCoverageCount"}}},"PublishedAnalyticsCommonFilters":{"type":"object","additionalProperties":false,"required":["currency","currency_basis","import","period_start","period_end"],"properties":{"currency":{"$ref":"#/components/schemas/CurrencyCode"},"currency_basis":{"$ref":"#/components/schemas/CurrencyBasis"},"import":{"$ref":"#/components/schemas/NullableUuid"},"period_start":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ReportMonth"}]},"period_end":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ReportMonth"}]}}},"PublishedAnalyticsSummary":{"type":"object","additionalProperties":false,"required":["currency","currency_basis","rows","imports","generations","published_at","totals","coverage"],"properties":{"currency":{"$ref":"#/components/schemas/CurrencyCode"},"currency_basis":{"$ref":"#/components/schemas/CurrencyBasis"},"rows":{"type":"integer","minimum":0},"imports":{"type":"integer","minimum":0},"generations":{"type":"integer","minimum":0},"published_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"totals":{"$ref":"#/components/schemas/PublishedAnalyticsTotals"},"coverage":{"$ref":"#/components/schemas/PublishedAnalyticsCoverage"}}},"PublishedAnalyticsSummaryResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublishedAnalyticsSummary"},"meta":{"type":"object","additionalProperties":false,"required":["scope","filters"],"properties":{"scope":{"type":"string","const":"published_generation"},"filters":{"$ref":"#/components/schemas/PublishedAnalyticsCommonFilters"}}}}},"PublishedAnalyticsFilterOption":{"type":"object","additionalProperties":false,"required":["key","state","rows","imports","generations"],"properties":{"key":{"type":["string","null"],"maxLength":160},"state":{"$ref":"#/components/schemas/CommercialValueState"},"rows":{"type":"integer","minimum":1},"imports":{"type":"integer","minimum":1},"generations":{"type":"integer","minimum":1}}},"PublishedAnalyticsFilterDimension":{"type":"object","additionalProperties":false,"required":["name","options","suppressed_rows"],"properties":{"name":{"$ref":"#/components/schemas/CommercialDimension"},"options":{"type":"array","items":{"$ref":"#/components/schemas/PublishedAnalyticsFilterOption"}},"suppressed_rows":{"type":"integer","minimum":0}}},"PublishedAnalyticsFilterOptionsFilters":{"type":"object","additionalProperties":false,"required":["currency","currency_basis","import","period_start","period_end","basis","taxonomy"],"properties":{"currency":{"$ref":"#/components/schemas/CurrencyCode"},"currency_basis":{"$ref":"#/components/schemas/CurrencyBasis"},"import":{"$ref":"#/components/schemas/NullableUuid"},"period_start":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ReportMonth"}]},"period_end":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ReportMonth"}]},"basis":{"$ref":"#/components/schemas/RateBasis"},"taxonomy":{"$ref":"#/components/schemas/NullableUuid"}}},"PublishedAnalyticsFilterOptionsResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","minItems":11,"maxItems":11,"items":{"$ref":"#/components/schemas/PublishedAnalyticsFilterDimension"}},"meta":{"type":"object","additionalProperties":false,"required":["scope","privacy","filters"],"properties":{"scope":{"type":"string","const":"published_generation"},"privacy":{"type":"object","additionalProperties":false,"required":["minimum_rows","suppression"],"properties":{"minimum_rows":{"type":"integer","minimum":2,"maximum":10000},"suppression":{"type":"string","const":"aggregate_only"}}},"filters":{"$ref":"#/components/schemas/PublishedAnalyticsFilterOptionsFilters"}}}}},"PublishedAnalyticsReadinessCount":{"type":"object","additionalProperties":false,"required":["rows","imports","generations","published_at"],"properties":{"rows":{"type":"integer","minimum":0},"imports":{"type":"integer","minimum":0},"generations":{"type":"integer","minimum":0},"published_at":{"$ref":"#/components/schemas/NullableIsoDateTime"}}},"PublishedAnalyticsReadiness":{"type":"object","additionalProperties":false,"required":["status","stale","published_at","publications","market","rates"],"properties":{"status":{"type":"string","enum":["empty","degraded","stale","ready"]},"stale":{"type":"boolean"},"published_at":{"$ref":"#/components/schemas/NullableIsoDateTime"},"publications":{"$ref":"#/components/schemas/PublishedAnalyticsReadinessCount"},"market":{"$ref":"#/components/schemas/PublishedAnalyticsReadinessCount"},"rates":{"$ref":"#/components/schemas/PublishedAnalyticsReadinessCount"}}},"PublishedAnalyticsReadinessResponse":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PublishedAnalyticsReadiness"},"meta":{"type":"object","additionalProperties":false,"required":["scope","stale_after_seconds"],"properties":{"scope":{"type":"string","const":"published_generation"},"stale_after_seconds":{"type":"integer","minimum":300,"maximum":31536000}}}}},"PublishedRateDimension":{"type":"object","additionalProperties":false,"required":["name","key","state"],"properties":{"name":{"$ref":"#/components/schemas/CommercialDimension"},"key":{"type":["string","null"],"maxLength":160},"state":{"$ref":"#/components/schemas/CommercialValueState"}}},"PublishedAnalyticsBreakdownAuthority":{"type":"object","additionalProperties":false,"required":["currency","currency_basis","rate_basis","taxonomy"],"properties":{"currency":{"$ref":"#/components/schemas/CurrencyCode"},"currency_basis":{"$ref":"#/components/schemas/CurrencyBasis"},"rate_basis":{"$ref":"#/components/schemas/RateBasis"},"taxonomy":{"$ref":"#/components/schemas/NullableUuid"}}},"PublishedAnalyticsBreakdownSide":{"type":"object","additionalProperties":false,"required":["eligible_rows","eligible_units","eligible_revenue"],"properties":{"eligible_rows":{"type":"integer","minimum":0},"eligible_units":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"eligible_revenue":{"$ref":"#/components/schemas/SignedCanonicalDecimal"}}},"PublishedAnalyticsBreakdownCoverage":{"type":"object","additionalProperties":false,"required":["territory","subscription_plan"],"properties":{"territory":{"$ref":"#/components/schemas/PublishedCoverageCount"},"subscription_plan":{"$ref":"#/components/schemas/PublishedCoverageCount"}}},"PublishedAnalyticsBreakdown":{"type":"object","additionalProperties":false,"required":["dimension","authority","rows","imports","generations","published_at","gross","net","coverage"],"properties":{"dimension":{"$ref":"#/components/schemas/PublishedRateDimension"},"authority":{"$ref":"#/components/schemas/PublishedAnalyticsBreakdownAuthority"},"rows":{"type":"integer","minimum":1},"imports":{"type":"integer","minimum":1},"generations":{"type":"integer","minimum":1},"published_at":{"$ref":"#/components/schemas/IsoDateTime"},"gross":{"$ref":"#/components/schemas/PublishedAnalyticsBreakdownSide"},"net":{"$ref":"#/components/schemas/PublishedAnalyticsBreakdownSide"},"coverage":{"$ref":"#/components/schemas/PublishedAnalyticsBreakdownCoverage"}}},"PublishedAnalyticsBreakdownPage":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/PublishedAnalyticsBreakdown"}},"meta":{"type":"object","additionalProperties":false,"required":["scope","dimension","next_cursor","filters"],"properties":{"scope":{"type":"string","const":"published_generation"},"dimension":{"$ref":"#/components/schemas/CommercialDimension"},"next_cursor":{"type":["string","null"],"maxLength":2048},"filters":{"$ref":"#/components/schemas/PublishedRateFilters"}}}}},"PublishedRateAuthority":{"type":"object","additionalProperties":false,"required":["currency","currency_basis","fx_set","rate_basis"],"properties":{"currency":{"$ref":"#/components/schemas/CurrencyCode"},"currency_basis":{"$ref":"#/components/schemas/CurrencyBasis"},"fx_set":{"$ref":"#/components/schemas/NullableUuid"},"rate_basis":{"$ref":"#/components/schemas/RateBasis"}}},"PublishedRateSide":{"type":"object","additionalProperties":false,"required":["rate","eligible_rows","eligible_units","eligible_revenue","low_sample"],"properties":{"rate":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/SignedCanonicalDecimal"}]},"eligible_rows":{"type":"integer","minimum":0},"eligible_units":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"eligible_revenue":{"$ref":"#/components/schemas/SignedCanonicalDecimal"},"low_sample":{"type":"boolean"}}},"PublishedRateCoverage":{"type":"object","additionalProperties":false,"required":["territory_percent","subscription_plan_percent"],"properties":{"territory_percent":{"type":["string","null"],"pattern":"^(?:0|[1-9][0-9]?|100)\\.[0-9]{10}$"},"subscription_plan_percent":{"type":["string","null"],"pattern":"^(?:0|[1-9][0-9]?|100)\\.[0-9]{10}$"}}},"PublishedObservedRate":{"type":"object","additionalProperties":false,"required":["import","generation","taxonomy","published_at","dimension","authority","metric","rows","gross","net","coverage","low_sample_units"],"properties":{"import":{"$ref":"#/components/schemas/Uuid"},"generation":{"$ref":"#/components/schemas/Uuid"},"taxonomy":{"$ref":"#/components/schemas/Uuid"},"published_at":{"$ref":"#/components/schemas/IsoDateTime"},"dimension":{"$ref":"#/components/schemas/PublishedRateDimension"},"authority":{"$ref":"#/components/schemas/PublishedRateAuthority"},"metric":{"type":"string","enum":["effective_cpm","per_unit_rate"]},"rows":{"type":"integer","minimum":1},"gross":{"$ref":"#/components/schemas/PublishedRateSide"},"net":{"$ref":"#/components/schemas/PublishedRateSide"},"coverage":{"$ref":"#/components/schemas/PublishedRateCoverage"},"low_sample_units":{"type":"integer","minimum":1,"maximum":1000000000}}},"PublishedRateFilters":{"type":"object","additionalProperties":false,"required":["currency","currency_basis","import","period_start","period_end","dimension","basis","taxonomy","state","key"],"properties":{"currency":{"$ref":"#/components/schemas/CurrencyCode"},"currency_basis":{"$ref":"#/components/schemas/CurrencyBasis"},"import":{"$ref":"#/components/schemas/NullableUuid"},"period_start":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ReportMonth"}]},"period_end":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ReportMonth"}]},"dimension":{"$ref":"#/components/schemas/CommercialDimension"},"basis":{"$ref":"#/components/schemas/RateBasis"},"taxonomy":{"$ref":"#/components/schemas/NullableUuid"},"state":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/CommercialValueState"}]},"key":{"type":["string","null"],"maxLength":160}}},"PublishedObservedRatePage":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/PublishedObservedRate"}},"meta":{"type":"object","additionalProperties":false,"required":["scope","dimension","next_cursor","filters"],"properties":{"scope":{"type":"string","const":"published_generation"},"dimension":{"$ref":"#/components/schemas/CommercialDimension"},"next_cursor":{"type":["string","null"],"maxLength":2048},"filters":{"$ref":"#/components/schemas/PublishedRateFilters"}}}}}}}}