{"openapi":"3.1.0","info":{"title":"StockFilm API","description":"Agent-native archival media licensing platform. Provides hybrid search, explicit rights verification, quote-based pricing, dual payment rails (Bitcoin Lightning and Solana), secure fulfillment, and admin tooling.","license":{"name":"Proprietary"},"version":"1.0.0"},"paths":{"/.well-known/stockfilm-agent.json":{"get":{"tags":["Discovery"],"summary":"GET /.well-known/stockfilm-agent.json — Discovery manifest for LLMs and agents.","operationId":"stockfilm_agent_manifest","responses":{"200":{"description":"StockFilm discovery manifest","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentManifestResponse"}}}}}}},"/admin/v1/asset-rights/{rights_id}/override":{"post":{"tags":["Admin"],"summary":"POST /admin/v1/asset-rights/{rights_id}/override — Override asset rights status.","operationId":"admin_override_rights","parameters":[{"name":"rights_id","in":"path","description":"Asset rights record ID","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OverrideRightsRequest"}}},"required":true},"responses":{"200":{"description":"Rights overridden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RightsOverrideResponse"}}}},"400":{"description":"Invalid rights status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminError"}}}},"404":{"description":"Rights record not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminError"}}}}},"security":[{"api_key":[]}]}},"/admin/v1/assets/{asset_id}/automatable":{"post":{"tags":["Admin"],"summary":"POST /admin/v1/assets/{asset_id}/automatable — Change asset automatable flag.","operationId":"admin_update_automatable","parameters":[{"name":"asset_id","in":"path","description":"Asset ID","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAutomatableRequest"}}},"required":true},"responses":{"200":{"description":"Automatable flag updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetStatusOverrideResponse"}}}},"404":{"description":"Asset not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminError"}}}}},"security":[{"api_key":[]}]}},"/admin/v1/assets/{asset_id}/visibility":{"post":{"tags":["Admin"],"summary":"POST /admin/v1/assets/{asset_id}/visibility — Change asset visibility.","operationId":"admin_update_visibility","parameters":[{"name":"asset_id","in":"path","description":"Asset ID","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateVisibilityRequest"}}},"required":true},"responses":{"200":{"description":"Visibility updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetStatusOverrideResponse"}}}},"400":{"description":"Invalid visibility value","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminError"}}}},"404":{"description":"Asset not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminError"}}}}},"security":[{"api_key":[]}]}},"/admin/v1/audit-events":{"get":{"tags":["Admin"],"summary":"GET /admin/v1/audit-events — List and filter admin audit events.","operationId":"list_audit_events","parameters":[{"name":"action","in":"query","description":"Filter by action","required":false,"schema":{"type":"string"}},{"name":"target_entity","in":"query","description":"Filter by target entity type","required":false,"schema":{"type":"string"}},{"name":"actor_id","in":"query","description":"Filter by actor principal ID","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"target_id","in":"query","description":"Filter by target entity ID","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","description":"Results per page (max 100)","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Pagination cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"List of audit events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAuditEventsResponse"}}}},"400":{"description":"Invalid cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminError"}}}}},"security":[{"api_key":[]}]}},"/admin/v1/audit-events/{event_id}":{"get":{"tags":["Admin"],"summary":"GET /admin/v1/audit-events/{event_id} — Get a single audit event.","operationId":"get_audit_event","parameters":[{"name":"event_id","in":"path","description":"Audit event ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Audit event details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditEventResponse"}}}},"404":{"description":"Event not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminError"}}}}},"security":[{"api_key":[]}]}},"/admin/v1/licenses/{license_id}":{"get":{"tags":["Admin"],"summary":"GET /admin/v1/licenses/{license_id} — Inspect a license transaction.","description":"Returns the full license record with linked payment intent and quote\nsummaries for settlement diagnosis.","operationId":"admin_inspect_license","parameters":[{"name":"license_id","in":"path","description":"License transaction ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"License with linked records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminLicenseResponse"}}}},"404":{"description":"License not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminError"}}}}},"security":[{"api_key":[]}]}},"/admin/v1/manual-review-cases":{"get":{"tags":["Admin"],"summary":"GET /admin/v1/manual-review-cases — List and filter manual-review cases.","operationId":"list_manual_review_cases","parameters":[{"name":"case_type","in":"query","description":"Filter by case type","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filter by status","required":false,"schema":{"type":"string"}},{"name":"assigned_to","in":"query","description":"Filter by assignee","required":false,"schema":{"type":"string"}},{"name":"priority","in":"query","description":"Filter by priority","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Results per page (max 100)","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"cursor","in":"query","description":"Pagination cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"List of manual review cases","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListManualReviewCasesResponse"}}}},"400":{"description":"Invalid cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminError"}}}},"403":{"description":"Insufficient role"}},"security":[{"api_key":[]}]}},"/admin/v1/manual-review-cases/{case_id}":{"get":{"tags":["Admin"],"summary":"GET /admin/v1/manual-review-cases/{case_id} — Inspect a single case.","operationId":"get_manual_review_case","parameters":[{"name":"case_id","in":"path","description":"Manual review case ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Manual review case details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManualReviewCaseResponse"}}}},"404":{"description":"Case not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminError"}}}}},"security":[{"api_key":[]}]}},"/admin/v1/me":{"get":{"tags":["Admin"],"summary":"Returns the authenticated admin principal's identity.\nVerifies that the caller has admin-level access.","operationId":"admin_me","responses":{"200":{"description":"Admin principal identity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}},"401":{"description":"Missing or invalid API key"},"403":{"description":"Insufficient role"}},"security":[{"api_key":[]}]}},"/admin/v1/payment-intents/{intent_id}":{"get":{"tags":["Admin"],"summary":"GET /admin/v1/payment-intents/{intent_id} — Inspect a payment intent.","description":"Returns the full payment intent record with inline events for settlement\ndiagnosis.","operationId":"admin_inspect_payment_intent","parameters":[{"name":"intent_id","in":"path","description":"Payment intent ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Payment intent with events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminPaymentIntentResponse"}}}},"404":{"description":"Payment intent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminError"}}}}},"security":[{"api_key":[]}]}},"/admin/v1/payment-intents/{intent_id}/events":{"get":{"tags":["Admin"],"summary":"GET /admin/v1/payment-intents/{intent_id}/events — List payment events.","description":"Returns all payment events for a given intent, ordered by observed_at ASC.","operationId":"admin_list_payment_events","parameters":[{"name":"intent_id","in":"path","description":"Payment intent ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Payment event list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminPaymentEventsListResponse"}}}},"404":{"description":"Payment intent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminError"}}}}},"security":[{"api_key":[]}]}},"/for-agents":{"get":{"tags":["Discovery"],"summary":"GET /for-agents — Human-readable integration guide for autonomous clients.","operationId":"for_agents","responses":{"200":{"description":"Agent integration guide","content":{"text/markdown":{"schema":{"type":"string"}}}}}}},"/health":{"get":{"tags":["Health"],"summary":"Liveness probe — returns 200 if the process is running.","operationId":"health","responses":{"200":{"description":"Service is running","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/llms.txt":{"get":{"tags":["Discovery"],"summary":"GET /llms.txt — Redirect to the canonical llms.txt on stockfilm.com.","operationId":"llms_txt","responses":{"301":{"description":"Redirect to canonical llms.txt"}}}},"/ready":{"get":{"tags":["Health"],"summary":"Readiness probe — returns 200 when the service can accept traffic.","description":"Future stories will extend this to verify database/cache connectivity;\nfor now it mirrors the health check.","operationId":"ready","responses":{"200":{"description":"Service is ready","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/v1/assets/{asset_id}":{"get":{"tags":["Assets"],"summary":"GET /v1/assets/{asset_id} — Canonical asset lookup.","operationId":"get_asset","parameters":[{"name":"asset_id","in":"path","description":"Asset ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Asset details with renditions, rights, and lineage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAssetResponse"}}}},"404":{"description":"Asset not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}}},"security":[{"api_key":[]}]}},"/v1/assets/{asset_id}/download-token":{"post":{"tags":["Tokens"],"summary":"POST /v1/assets/{asset_id}/download-token — Issue a time-limited download\ntoken for the master rendition of a licensed asset.","description":"Requires an active license entitlement for the requesting tenant on the\ngiven asset. Returns 404 for missing/cross-tenant assets, 409 when the\ntenant has no active license or the asset lacks a master rendition.","operationId":"create_download_token","parameters":[{"name":"asset_id","in":"path","description":"Asset ID","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDownloadTokenRequest"}}},"required":true},"responses":{"201":{"description":"Download token issued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDownloadTokenResponse"}}}},"400":{"description":"Invalid TTL","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}},"404":{"description":"Asset or active license not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}},"409":{"description":"License not active, expired, no master rendition, or token already issued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}},"429":{"description":"Per-license or per-tenant download budget exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}}},"security":[{"api_key":[]}]}},"/v1/assets/{asset_id}/preview-token":{"post":{"tags":["Tokens"],"summary":"POST /v1/assets/{asset_id}/preview-token — Issue a time-limited preview\ntoken for an asset's preview rendition.","description":"The asset must be active, machine-ready, and have at least one available\npreview rendition. Returns 404 for missing/cross-tenant assets and 409\nwhen the asset is not eligible or lacks a preview rendition.","operationId":"create_preview_token","parameters":[{"name":"asset_id","in":"path","description":"Asset ID","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePreviewTokenRequest"}}},"required":true},"responses":{"201":{"description":"Preview token issued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePreviewTokenResponse"}}}},"400":{"description":"Invalid TTL","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}},"404":{"description":"Asset not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}},"409":{"description":"Asset not eligible or no preview rendition","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}}},"security":[{"api_key":[]}]}},"/v1/assets/{asset_id}/rights":{"get":{"tags":["Assets"],"summary":"GET /v1/assets/{asset_id}/rights — Explicit rights lookup for an asset.","operationId":"get_asset_rights","parameters":[{"name":"asset_id","in":"path","description":"Asset ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Asset rights records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAssetRightsResponse"}}}},"404":{"description":"Asset not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}}},"security":[{"api_key":[]}]}},"/v1/capabilities":{"get":{"tags":["Discovery"],"summary":"GET /v1/capabilities — Machine-readable capability surface for autonomous clients.","operationId":"get_capabilities","responses":{"200":{"description":"Agent capability document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilitiesResponse"}}}}}}},"/v1/licenses/execute":{"post":{"tags":["Licenses"],"summary":"POST /v1/licenses/execute — Finalize a quote into a license lifecycle\ntied to a payment intent.","description":"Validates that the quote and payment intent exist, belong to the calling\ntenant, and are linked. Returns the current license state and a next-action\nhint indicating what the client should do. Does NOT activate unpaid licenses.","operationId":"execute_license","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecuteLicenseRequest"}}},"required":true},"responses":{"200":{"description":"License execution result with next-action hint","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecuteLicenseResponse"}}}},"400":{"description":"Mismatched references","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}},"404":{"description":"Quote, payment intent, or license not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}}},"security":[{"api_key":[]}]}},"/v1/licenses/{license_id}":{"get":{"tags":["Licenses"],"summary":"GET /v1/licenses/{license_id} — Retrieve a license by ID.","operationId":"get_license","parameters":[{"name":"license_id","in":"path","description":"License transaction ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"License details with payment summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetLicenseResponse"}}}},"404":{"description":"License not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}}},"security":[{"api_key":[]}]}},"/v1/me":{"get":{"tags":["Identity"],"summary":"Returns the authenticated principal's identity. Useful for verifying\nthat an API key is valid and inspecting the associated tenant/role.","operationId":"me","responses":{"200":{"description":"Authenticated principal identity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}},"401":{"description":"Missing or invalid API key"}},"security":[{"api_key":[]}]}},"/v1/payment-intents":{"post":{"tags":["Payments"],"summary":"POST /v1/payment-intents — Create a payment intent from a valid, unexpired quote.","operationId":"create_payment_intent","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePaymentIntentApiRequest"}}},"required":true},"responses":{"200":{"description":"Payment intent created with provider instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePaymentIntentResponse"}}}},"400":{"description":"Quote not open or expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}},"404":{"description":"Quote not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}}},"security":[{"api_key":[]}]}},"/v1/payment-intents/{intent_id}":{"get":{"tags":["Payments"],"summary":"GET /v1/payment-intents/{intent_id} — Retrieve a payment intent by ID.","operationId":"get_payment_intent","parameters":[{"name":"intent_id","in":"path","description":"Payment intent ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Payment intent details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPaymentIntentResponse"}}}},"404":{"description":"Payment intent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}}},"security":[{"api_key":[]}]}},"/v1/quotes":{"post":{"tags":["Quotes"],"summary":"POST /v1/quotes — Create a price quote for licensing an asset.","operationId":"create_quote","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateQuoteRequest"}}},"required":true},"responses":{"200":{"description":"Quote created or retrieved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateQuoteResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}},"404":{"description":"Asset not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}}},"security":[{"api_key":[]}]}},"/v1/quotes/{quote_id}":{"get":{"tags":["Quotes"],"summary":"GET /v1/quotes/{quote_id} — Retrieve a quote by ID with live expiry status.","operationId":"get_quote","parameters":[{"name":"quote_id","in":"path","description":"Quote ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Quote details with live expiry status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetQuoteResponse"}}}},"404":{"description":"Quote not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}}},"security":[{"api_key":[]}]}},"/v1/receipts/{receipt_id}":{"get":{"tags":["Receipts"],"summary":"GET /v1/receipts/{receipt_id} — Retrieve a receipt by ID.","description":"Returns the signed receipt payload and verification metadata.\nInternal-only provider secrets and raw confidential event data are not\nexposed — only the fields needed for independent verification.","operationId":"get_receipt","parameters":[{"name":"receipt_id","in":"path","description":"Receipt ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Receipt with verification metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetReceiptResponse"}}}},"404":{"description":"Receipt not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}}},"security":[{"api_key":[]}]}},"/v1/rights/verify":{"post":{"tags":["Rights"],"summary":"POST /v1/rights/verify — Check whether an asset is auto-licensable for a\ngiven use scope, territory, and term.","operationId":"verify_rights","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyRightsRequest"}}},"required":true},"responses":{"200":{"description":"Rights verification result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyRightsResponse"}}}},"400":{"description":"Invalid intended use","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}},"404":{"description":"Asset not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}}},"security":[{"api_key":[]}]}},"/v1/search/assets":{"post":{"tags":["Search"],"summary":"POST /v1/search/assets — Search the archival media catalog.","operationId":"search_assets","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchAssetsRequest"}}},"required":true},"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchAssetsResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchError"}}}}},"security":[{"api_key":[]}]}},"/v1/search/similar":{"post":{"tags":["Search"],"summary":"POST /v1/search/similar — Find assets similar to a seed asset.","operationId":"search_similar","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchSimilarRequest"}}},"required":true},"responses":{"200":{"description":"Similar assets","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchSimilarResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchError"}}}},"404":{"description":"Seed asset not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchError"}}}}},"security":[{"api_key":[]}]}},"/v1/webhooks/license-status":{"post":{"tags":["Webhooks"],"summary":"POST /v1/webhooks/license-status — Subscribe to license status webhooks.","operationId":"create_license_status_webhook","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateStatusWebhookRequest"}}},"required":true},"responses":{"200":{"description":"License-status webhook subscription created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateStatusWebhookResponse"}}}},"400":{"description":"Invalid URL","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}}},"security":[{"api_key":[]}]}},"/v1/webhooks/payment-status":{"post":{"tags":["Webhooks"],"summary":"POST /v1/webhooks/payment-status — Subscribe to payment status webhooks.","operationId":"create_payment_status_webhook","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateStatusWebhookRequest"}}},"required":true},"responses":{"200":{"description":"Payment-status webhook subscription created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateStatusWebhookResponse"}}}},"400":{"description":"Invalid URL","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetError"}}}}},"security":[{"api_key":[]}]}}},"components":{"schemas":{"AdminError":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}},"AdminLicenseResponse":{"type":"object","description":"Response body for GET /admin/v1/licenses/{license_id}.","required":["id","tenant_id","asset_id","quote_id","usage_scope","territory","status","fulfillment_meta","created_at","updated_at"],"properties":{"activated_at":{"type":["string","null"],"format":"date-time"},"asset_id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"fulfilled_at":{"type":["string","null"],"format":"date-time"},"fulfillment_meta":{"type":"object"},"id":{"type":"string","format":"uuid"},"payment_intent":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/AdminLinkedPaymentIntent","description":"Linked payment intent summary, if one exists."}]},"quote":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/AdminLinkedQuote","description":"Linked quote summary."}]},"quote_id":{"type":"string","format":"uuid"},"status":{"type":"string"},"tenant_id":{"type":"string","format":"uuid"},"term_end":{"type":["string","null"],"format":"date"},"term_start":{"type":["string","null"],"format":"date"},"territory":{"type":"string"},"updated_at":{"type":"string","format":"date-time"},"usage_scope":{"type":"string"}}},"AdminLinkedPaymentIntent":{"type":"object","description":"Embedded payment intent summary within a license inspection response.","required":["id","rail","amount_cents","currency","status"],"properties":{"amount_cents":{"type":"integer","format":"int64"},"currency":{"type":"string"},"id":{"type":"string","format":"uuid"},"rail":{"$ref":"#/components/schemas/ApiPaymentRail"},"rail_payment_id":{"type":["string","null"]},"settlement_amount":{"type":["integer","null"],"format":"int64"},"settlement_currency":{"type":["string","null"]},"status":{"type":"string"}}},"AdminLinkedQuote":{"type":"object","description":"Embedded quote summary within a license inspection response.","required":["id","asset_id","usage_scope","territory","price_amount_cents","price_currency","selected_rail","status","expires_at"],"properties":{"asset_id":{"type":"string","format":"uuid"},"expires_at":{"type":"string","format":"date-time"},"id":{"type":"string","format":"uuid"},"price_amount_cents":{"type":"integer","format":"int64"},"price_currency":{"type":"string"},"selected_rail":{"$ref":"#/components/schemas/ApiPaymentRail"},"status":{"type":"string"},"territory":{"type":"string"},"usage_scope":{"type":"string"}}},"AdminPaymentEventResponse":{"type":"object","description":"Response body for individual payment events.","required":["id","payment_intent_id","event_type","observed_at","raw_payload","created_at"],"properties":{"created_at":{"type":"string","format":"date-time"},"event_type":{"type":"string"},"id":{"type":"string","format":"uuid"},"observed_at":{"type":"string","format":"date-time"},"payment_intent_id":{"type":"string","format":"uuid"},"rail_reference":{"type":["string","null"]},"rail_status":{"type":["string","null"]},"raw_payload":{"type":"object"}}},"AdminPaymentEventsListResponse":{"type":"object","description":"Response wrapper for listing payment events.","required":["payment_intent_id","events"],"properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/AdminPaymentEventResponse"}},"payment_intent_id":{"type":"string","format":"uuid"}}},"AdminPaymentIntentResponse":{"type":"object","description":"Response body for GET /admin/v1/payment-intents/{intent_id}.","required":["id","tenant_id","quote_id","license_transaction_id","rail","amount_cents","currency","status","created_at","updated_at","events"],"properties":{"amount_cents":{"type":"integer","format":"int64"},"created_at":{"type":"string","format":"date-time"},"currency":{"type":"string"},"events":{"type":"array","items":{"$ref":"#/components/schemas/AdminPaymentEventResponse"},"description":"Inline events for quick diagnosis."},"exchange_rate_used":{"type":["number","null"],"format":"double"},"expires_at":{"type":["string","null"],"format":"date-time"},"id":{"type":"string","format":"uuid"},"license_transaction_id":{"type":"string","format":"uuid"},"quote_id":{"type":"string","format":"uuid"},"rail":{"$ref":"#/components/schemas/ApiPaymentRail"},"rail_payment_id":{"type":["string","null"]},"settlement_amount":{"type":["integer","null"],"format":"int64"},"settlement_currency":{"type":["string","null"]},"status":{"type":"string"},"tenant_id":{"type":"string","format":"uuid"},"updated_at":{"type":"string","format":"date-time"}}},"AgentManifestAuthModel":{"type":"object","required":["scheme","api_key_headers","request_signing","idempotency_header"],"properties":{"api_key_headers":{"type":"array","items":{"type":"string"}},"idempotency_header":{"type":"string"},"request_signing":{"type":"string"},"scheme":{"type":"string"}}},"AgentManifestMcpInfo":{"type":"object","required":["enabled","endpoint","transport","tools"],"properties":{"enabled":{"type":"boolean"},"endpoint":{"type":"string"},"tools":{"type":"array","items":{"type":"string"}},"transport":{"type":"string"}}},"AgentManifestResponse":{"type":"object","required":["name","description","website_url","api_base_url","docs_url","openapi_url","capabilities_url","llms_txt_url","auth","canonical_flow","x402","mcp"],"properties":{"api_base_url":{"type":"string"},"auth":{"$ref":"#/components/schemas/AgentManifestAuthModel"},"canonical_flow":{"type":"array","items":{"type":"string"}},"capabilities_url":{"type":"string"},"description":{"type":"string"},"docs_url":{"type":"string"},"llms_txt_url":{"type":"string"},"mcp":{"$ref":"#/components/schemas/AgentManifestMcpInfo"},"name":{"type":"string"},"openapi_url":{"type":"string"},"website_url":{"type":"string"},"x402":{"$ref":"#/components/schemas/AgentManifestX402Info"}}},"AgentManifestX402Info":{"type":"object","required":["enabled","search","clip_details","rights","license","price_usd","networks"],"properties":{"clip_details":{"type":"string"},"enabled":{"type":"boolean"},"license":{"type":"string"},"networks":{"type":"array","items":{"type":"string"}},"price_usd":{"type":"string"},"rights":{"type":"string"},"search":{"type":"string"}}},"ApiPaymentRail":{"type":"string","description":"Canonical public payment rail values for API contracts.","enum":["lightning_btc","solana_sol","solana_usdc"]},"AssetError":{"type":"object","description":"Error response for asset endpoints.","required":["error","message"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}},"AssetRightsDetail":{"type":"object","description":"Rights detail in the dedicated rights endpoint response.","required":["id","rights_status","confidence","manual_review_required","allowed_uses","prohibited_uses","territory","created_at","updated_at"],"properties":{"allowed_uses":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number","format":"float"},"created_at":{"type":"string","format":"date-time"},"id":{"type":"string","format":"uuid"},"manual_review_required":{"type":"boolean"},"prohibited_uses":{"type":"array","items":{"type":"string"}},"rights_status":{"type":"string"},"term_end":{"type":["string","null"],"format":"date"},"term_start":{"type":["string","null"],"format":"date"},"territory":{"type":"string"},"updated_at":{"type":"string","format":"date-time"}}},"AssetRightsSummary":{"type":"object","description":"Rights summary in the asset detail response.","required":["rights_status","confidence","manual_review_required","allowed_uses","prohibited_uses","territory"],"properties":{"allowed_uses":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number","format":"float"},"manual_review_required":{"type":"boolean"},"prohibited_uses":{"type":"array","items":{"type":"string"}},"rights_status":{"type":"string"},"territory":{"type":"string"}}},"AssetStatusOverrideResponse":{"type":"object","description":"Response for admin asset status override endpoints.","required":["asset_id","visibility","automatable","machine_ready","status","audit_event_id","updated_at"],"properties":{"asset_id":{"type":"string","format":"uuid"},"audit_event_id":{"type":"string","format":"uuid"},"automatable":{"type":"boolean"},"machine_ready":{"type":"boolean"},"status":{"type":"string"},"updated_at":{"type":"string","format":"date-time"},"visibility":{"type":"string"}}},"AuditEventResponse":{"type":"object","required":["id","tenant_id","actor_id","action","target_entity","target_id","reason","event_meta","created_at"],"properties":{"action":{"type":"string"},"actor_id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"event_meta":{"type":"object"},"id":{"type":"string","format":"uuid"},"new_value":{"type":["string","null"]},"old_value":{"type":["string","null"]},"reason":{"type":"string"},"target_entity":{"type":"string"},"target_id":{"type":"string","format":"uuid"},"tenant_id":{"type":"string","format":"uuid"}}},"CapabilitiesAuthModel":{"type":"object","required":["api_key_headers","hmac_required_methods","hmac_payload_format","max_clock_skew_seconds","idempotency_header","idempotency_required_for_mutations"],"properties":{"api_key_headers":{"type":"array","items":{"type":"string"}},"hmac_payload_format":{"type":"string"},"hmac_required_methods":{"type":"array","items":{"type":"string"}},"idempotency_header":{"type":"string"},"idempotency_required_for_mutations":{"type":"boolean"},"max_clock_skew_seconds":{"type":"integer","format":"int32"}}},"CapabilitiesEndpoint":{"type":"object","required":["method","path","purpose"],"properties":{"method":{"type":"string"},"path":{"type":"string"},"purpose":{"type":"string"}}},"CapabilitiesRail":{"type":"object","required":["rail","settlement_asset","instruction_fields","payment_statuses"],"properties":{"instruction_fields":{"type":"array","items":{"type":"string"}},"payment_statuses":{"type":"array","items":{"type":"string"}},"rail":{"$ref":"#/components/schemas/ApiPaymentRail"},"settlement_asset":{"type":"string"}}},"CapabilitiesResponse":{"type":"object","required":["service","version","website_url","docs_url","openapi_url","auth","rails","usage_scopes","search_filters","webhooks","workflow","key_endpoints"],"properties":{"auth":{"$ref":"#/components/schemas/CapabilitiesAuthModel"},"docs_url":{"type":"string"},"key_endpoints":{"type":"array","items":{"$ref":"#/components/schemas/CapabilitiesEndpoint"}},"openapi_url":{"type":"string"},"rails":{"type":"array","items":{"$ref":"#/components/schemas/CapabilitiesRail"}},"search_filters":{"type":"array","items":{"type":"string"}},"service":{"type":"string"},"usage_scopes":{"type":"array","items":{"type":"string"}},"version":{"type":"string"},"webhooks":{"type":"array","items":{"type":"string"}},"website_url":{"type":"string"},"workflow":{"type":"array","items":{"type":"string"}}}},"CreateDownloadTokenRequest":{"type":"object","description":"Request body for POST /v1/assets/{asset_id}/download-token.","properties":{"ttl_minutes":{"type":["integer","null"],"format":"int64","description":"Optional TTL in minutes (default 10)."}}},"CreateDownloadTokenResponse":{"type":"object","description":"Response for POST /v1/assets/{asset_id}/download-token.","required":["token_id","download_event_id","asset_id","asset_rendition_id","expires_at"],"properties":{"asset_id":{"type":"string","format":"uuid"},"asset_rendition_id":{"type":"string","format":"uuid"},"download_event_id":{"type":"string","format":"uuid"},"expires_at":{"type":"string"},"token_id":{"type":"string"}}},"CreatePaymentIntentApiRequest":{"type":"object","description":"Request body for POST /v1/payment-intents.","required":["quote_id"],"properties":{"quote_id":{"type":"string","format":"uuid","description":"The quote to create a payment intent for."}}},"CreatePaymentIntentResponse":{"type":"object","description":"Response body for POST /v1/payment-intents.","required":["payment_intent_id","quote_id","license_transaction_id","rail","amount_cents","currency","status","instructions","created_at"],"properties":{"amount_cents":{"type":"integer","format":"int64"},"created_at":{"type":"string","format":"date-time"},"currency":{"type":"string"},"expires_at":{"type":["string","null"],"format":"date-time"},"instructions":{"type":"object"},"license_transaction_id":{"type":"string","format":"uuid"},"payment_intent_id":{"type":"string","format":"uuid"},"quote_id":{"type":"string","format":"uuid"},"rail":{"$ref":"#/components/schemas/ApiPaymentRail"},"rail_payment_id":{"type":["string","null"]},"status":{"type":"string"}}},"CreatePreviewTokenRequest":{"type":"object","description":"Request body for POST /v1/assets/{asset_id}/preview-token.","properties":{"ttl_minutes":{"type":["integer","null"],"format":"int64","description":"Optional TTL in minutes (default 15)."}}},"CreatePreviewTokenResponse":{"type":"object","description":"Response for POST /v1/assets/{asset_id}/preview-token.","required":["token_id","preview_token_id","asset_id","asset_rendition_id","expires_at"],"properties":{"asset_id":{"type":"string","format":"uuid"},"asset_rendition_id":{"type":"string","format":"uuid"},"expires_at":{"type":"string"},"preview_token_id":{"type":"string","format":"uuid"},"token_id":{"type":"string"}}},"CreateQuoteRequest":{"type":"object","description":"Request body for POST /v1/quotes.","required":["asset_id","usage_scope","selected_rail"],"properties":{"asset_id":{"type":"string","format":"uuid","description":"The asset to quote for licensing."},"selected_rail":{"$ref":"#/components/schemas/ApiPaymentRail","description":"Desired payment rail: \"lightning_btc\", \"solana_sol\", or \"solana_usdc\"."},"term_end":{"type":["string","null"],"format":"date","description":"Desired license term end date (NULL = perpetual)."},"term_start":{"type":["string","null"],"format":"date","description":"Desired license term start date."},"territory":{"type":["string","null"],"description":"Territory for the license (e.g. \"worldwide\", \"US\"). Defaults to empty string."},"ttl_seconds":{"type":["integer","null"],"format":"int64","description":"Quote TTL in seconds. Defaults to 3600 (1 hour)."},"usage_scope":{"type":"string","description":"The intended use scope (e.g. \"commercial\", \"editorial\")."}}},"CreateQuoteResponse":{"type":"object","description":"Response body for POST /v1/quotes.","required":["quote_id","asset_id","usage_scope","territory","price_amount_cents","price_currency","tier_label","selected_rail","expires_at","quote_hash","status","created_at"],"properties":{"asset_id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"},"price_amount_cents":{"type":"integer","format":"int64"},"price_currency":{"type":"string"},"quote_hash":{"type":"string"},"quote_id":{"type":"string","format":"uuid"},"selected_rail":{"$ref":"#/components/schemas/ApiPaymentRail"},"status":{"type":"string"},"term_end":{"type":["string","null"],"format":"date"},"term_start":{"type":["string","null"],"format":"date"},"territory":{"type":"string"},"tier_label":{"type":"string"},"usage_scope":{"type":"string"}}},"CreateStatusWebhookRequest":{"type":"object","description":"Request body for webhook status subscription endpoints.","required":["url"],"properties":{"signing_secret":{"type":["string","null"],"description":"Optional HMAC secret. If omitted, the server generates one."},"url":{"type":"string","description":"HTTPS endpoint that receives signed webhook POSTs."}}},"CreateStatusWebhookResponse":{"type":"object","description":"Response body for webhook status subscription endpoints.","required":["subscription_id","url","event_types","status","created_at"],"properties":{"created_at":{"type":"string","format":"date-time"},"event_types":{"type":"array","items":{"type":"string"}},"status":{"type":"string"},"subscription_id":{"type":"string","format":"uuid"},"url":{"type":"string"}}},"DeliveryFileInfo":{"type":"object","required":["mode","filename"],"properties":{"clip_id":{"type":["string","null"],"description":"Optional upstream clip identifier."},"filename":{"type":"string","description":"Filename to return to the agent when file delivery is staged."},"mode":{"type":"string","description":"Delivery mode for this fulfillment payload."}}},"ExecuteLicenseRequest":{"type":"object","description":"Request body for POST /v1/licenses/execute.","required":["quote_id","payment_intent_id"],"properties":{"payment_intent_id":{"type":"string","format":"uuid","description":"The payment intent that should cover this license."},"quote_id":{"type":"string","format":"uuid","description":"The quote this license is tied to."}}},"ExecuteLicenseResponse":{"type":"object","description":"Response body for POST /v1/licenses/execute.","required":["license_id","quote_id","payment_intent_id","asset_id","usage_scope","territory","status","created_at","updated_at"],"properties":{"activated_at":{"type":["string","null"],"format":"date-time"},"asset_id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"delivery_file":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/DeliveryFileInfo"}]},"license_id":{"type":"string","format":"uuid"},"next_action":{"type":["string","null"]},"payment_intent_id":{"type":"string","format":"uuid"},"quote_id":{"type":"string","format":"uuid"},"status":{"type":"string"},"term_end":{"type":["string","null"],"format":"date"},"term_start":{"type":["string","null"],"format":"date"},"territory":{"type":"string"},"updated_at":{"type":"string","format":"date-time"},"usage_scope":{"type":"string"}}},"GetAssetResponse":{"type":"object","description":"Response for GET /v1/assets/{asset_id}.","required":["id","tenant_id","title","description","media_type","status","machine_ready","has_thumbnail","has_preview","has_embeddings","tags","renditions","rights","lineage","created_at","updated_at"],"properties":{"aspect_ratio":{"type":["string","null"]},"codec":{"type":["string","null"]},"color_space":{"type":["string","null"]},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"duration_ms":{"type":["integer","null"],"format":"int32"},"estimated_price_cents":{"type":["integer","null"],"format":"int64"},"file_size_bytes":{"type":["integer","null"],"format":"int64"},"format":{"type":["string","null"]},"fps":{"type":["number","null"],"format":"float"},"has_embeddings":{"type":"boolean"},"has_preview":{"type":"boolean"},"has_thumbnail":{"type":"boolean"},"height":{"type":["integer","null"],"format":"int32"},"id":{"type":"string","format":"uuid"},"lineage":{"type":"array","items":{"$ref":"#/components/schemas/LineageSummary"}},"machine_ready":{"type":"boolean"},"media_type":{"type":"string"},"renditions":{"type":"array","items":{"$ref":"#/components/schemas/RenditionSummary"}},"rights":{"type":"array","items":{"$ref":"#/components/schemas/AssetRightsSummary"}},"status":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"tenant_id":{"type":"string","format":"uuid"},"title":{"type":"string"},"updated_at":{"type":"string","format":"date-time"},"width":{"type":["integer","null"],"format":"int32"}}},"GetAssetRightsResponse":{"type":"object","description":"Response for GET /v1/assets/{asset_id}/rights.","required":["asset_id","rights"],"properties":{"asset_id":{"type":"string","format":"uuid"},"rights":{"type":"array","items":{"$ref":"#/components/schemas/AssetRightsDetail"}}}},"GetLicenseResponse":{"type":"object","description":"Response body for GET /v1/licenses/{license_id}.","required":["license_id","asset_id","quote_id","usage_scope","territory","status","fulfillment_meta","receipt_available","created_at","updated_at"],"properties":{"activated_at":{"type":["string","null"],"format":"date-time"},"asset_id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"delivery_file":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/DeliveryFileInfo"}]},"fulfilled_at":{"type":["string","null"],"format":"date-time"},"fulfillment_meta":{"type":"object"},"license_id":{"type":"string","format":"uuid"},"payment":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/LicensePaymentSummary","description":"Summary of the linked payment intent, if one exists."}]},"quote_id":{"type":"string","format":"uuid"},"receipt_available":{"type":"boolean","description":"Whether a signed receipt has been issued for this license."},"status":{"type":"string"},"term_end":{"type":["string","null"],"format":"date"},"term_start":{"type":["string","null"],"format":"date"},"territory":{"type":"string"},"updated_at":{"type":"string","format":"date-time"},"usage_scope":{"type":"string"}}},"GetPaymentIntentResponse":{"type":"object","description":"Response body for GET /v1/payment-intents/{intent_id}.","required":["payment_intent_id","quote_id","license_transaction_id","rail","amount_cents","currency","status","instructions","created_at","updated_at"],"properties":{"amount_cents":{"type":"integer","format":"int64"},"created_at":{"type":"string","format":"date-time"},"currency":{"type":"string"},"exchange_rate_used":{"type":["number","null"],"format":"double"},"expires_at":{"type":["string","null"],"format":"date-time"},"instructions":{"type":"object"},"license_transaction_id":{"type":"string","format":"uuid"},"payment_intent_id":{"type":"string","format":"uuid"},"quote_id":{"type":"string","format":"uuid"},"rail":{"$ref":"#/components/schemas/ApiPaymentRail"},"rail_payment_id":{"type":["string","null"]},"settlement_amount":{"type":["integer","null"],"format":"int64"},"settlement_currency":{"type":["string","null"]},"status":{"type":"string"},"updated_at":{"type":"string","format":"date-time"}}},"GetQuoteResponse":{"type":"object","description":"Response body for GET /v1/quotes/{quote_id}.","required":["quote_id","asset_id","usage_scope","territory","price_amount_cents","price_currency","selected_rail","expires_at","quote_hash","status","created_at","updated_at","expired"],"properties":{"asset_id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"expired":{"type":"boolean"},"expires_at":{"type":"string","format":"date-time"},"price_amount_cents":{"type":"integer","format":"int64"},"price_currency":{"type":"string"},"quote_hash":{"type":"string"},"quote_id":{"type":"string","format":"uuid"},"selected_rail":{"$ref":"#/components/schemas/ApiPaymentRail"},"status":{"type":"string"},"term_end":{"type":["string","null"],"format":"date"},"term_start":{"type":["string","null"],"format":"date"},"territory":{"type":"string"},"updated_at":{"type":"string","format":"date-time"},"usage_scope":{"type":"string"}}},"GetReceiptResponse":{"type":"object","description":"Response body for GET /v1/receipts/{receipt_id}.","required":["receipt_id","license_transaction_id","receipt_hash","signature_algo","verification_meta","issued_at","notes","created_at","updated_at"],"properties":{"created_at":{"type":"string","format":"date-time"},"issued_at":{"type":"string","format":"date-time"},"license_transaction_id":{"type":"string","format":"uuid"},"notes":{"type":"string"},"payment_reference":{"type":["string","null"]},"quote_hash":{"type":["string","null"]},"receipt_hash":{"type":"string"},"receipt_id":{"type":"string","format":"uuid"},"signature":{"type":["string","null"]},"signature_algo":{"type":"string"},"updated_at":{"type":"string","format":"date-time"},"verification_meta":{"type":"object"}}},"HealthResponse":{"type":"object","required":["status"],"properties":{"status":{"type":"string"}}},"LicensePaymentSummary":{"type":"object","description":"Embedded payment summary within a license detail response.","required":["payment_intent_id","rail","amount_cents","currency","status"],"properties":{"amount_cents":{"type":"integer","format":"int64"},"currency":{"type":"string"},"payment_intent_id":{"type":"string","format":"uuid"},"rail":{"$ref":"#/components/schemas/ApiPaymentRail"},"status":{"type":"string"}}},"LineageSummary":{"type":"object","description":"Lineage event summary in the asset detail response.","required":["event_type","description","source_system","seq","created_at"],"properties":{"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"event_type":{"type":"string"},"seq":{"type":"integer","format":"int32"},"source_system":{"type":"string"}}},"ListAuditEventsQuery":{"type":"object","description":"Query parameters for GET /admin/v1/audit-events.","properties":{"action":{"type":["string","null"]},"actor_id":{"type":["string","null"],"format":"uuid"},"cursor":{"type":["string","null"]},"limit":{"type":["integer","null"],"format":"int64"},"target_entity":{"type":["string","null"]},"target_id":{"type":["string","null"],"format":"uuid"}}},"ListAuditEventsResponse":{"type":"object","required":["events"],"properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/AuditEventResponse"}},"next_cursor":{"type":["string","null"]}}},"ListManualReviewCasesQuery":{"type":"object","description":"Query parameters for GET /admin/v1/manual-review-cases.","properties":{"assigned_to":{"type":["string","null"]},"case_type":{"type":["string","null"]},"cursor":{"type":["string","null"]},"limit":{"type":["integer","null"],"format":"int64"},"priority":{"type":["string","null"]},"status":{"type":["string","null"]}}},"ListManualReviewCasesResponse":{"type":"object","required":["cases"],"properties":{"cases":{"type":"array","items":{"$ref":"#/components/schemas/ManualReviewCaseResponse"}},"next_cursor":{"type":["string","null"]}}},"ManualReviewCaseResponse":{"type":"object","required":["id","tenant_id","case_type","status","priority","assigned_to","reason","resolution_notes","created_at","updated_at"],"properties":{"asset_id":{"type":["string","null"],"format":"uuid"},"asset_rights_id":{"type":["string","null"],"format":"uuid"},"assigned_to":{"type":"string"},"case_type":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"id":{"type":"string","format":"uuid"},"payment_intent_id":{"type":["string","null"],"format":"uuid"},"priority":{"type":"string"},"quote_id":{"type":["string","null"],"format":"uuid"},"reason":{"type":"string"},"resolution_notes":{"type":"string"},"resolved_at":{"type":["string","null"],"format":"date-time"},"status":{"type":"string"},"tenant_id":{"type":"string","format":"uuid"},"updated_at":{"type":"string","format":"date-time"}}},"MeResponse":{"type":"object","required":["principal_id","tenant_id","label","role","scopes"],"properties":{"label":{"type":"string"},"principal_id":{"type":"string","format":"uuid"},"role":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"tenant_id":{"type":"string","format":"uuid"}}},"OverrideRightsRequest":{"type":"object","description":"Request body for POST /admin/v1/asset-rights/{rights_id}/override.","required":["rights_status","confidence","reason"],"properties":{"confidence":{"type":"number","format":"float"},"manual_review_required":{"type":["boolean","null"]},"reason":{"type":"string"},"review_case_id":{"type":["string","null"],"format":"uuid","description":"Optional manual-review case ID to link to the override."},"rights_status":{"type":"string"}}},"PolicyReason":{"type":"object","description":"A single policy reason returned in the verification response.","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"RenditionSummary":{"type":"object","description":"Summary of a rendition in the asset detail response.","required":["id","rendition_type","label","watermarked","status"],"properties":{"duration_ms":{"type":["integer","null"],"format":"int32"},"file_size_bytes":{"type":["integer","null"],"format":"int64"},"format":{"type":["string","null"]},"height":{"type":["integer","null"],"format":"int32"},"id":{"type":"string","format":"uuid"},"label":{"type":"string"},"rendition_type":{"type":"string"},"status":{"type":"string"},"watermarked":{"type":"boolean"},"width":{"type":["integer","null"],"format":"int32"}}},"RightsEvidenceInfo":{"type":"object","required":["references","notes","special_restrictions"],"properties":{"notes":{"type":"string"},"references":{"type":"object"},"special_restrictions":{"type":"object"}}},"RightsOverrideResponse":{"type":"object","description":"Response for admin rights override endpoint.","required":["rights_id","asset_id","rights_status","confidence","manual_review_required","audit_event_id","updated_at"],"properties":{"asset_id":{"type":"string","format":"uuid"},"audit_event_id":{"type":"string","format":"uuid"},"confidence":{"type":"number","format":"float"},"manual_review_required":{"type":"boolean"},"rights_id":{"type":"string","format":"uuid"},"rights_status":{"type":"string"},"updated_at":{"type":"string","format":"date-time"}}},"RightsPolicyBundle":{"type":"object","required":["rights_id","rights_status","confidence","manual_review_required","allowed_uses","prohibited_uses","commercial_eligible","editorial_eligible","release","territory","term","evidence"],"properties":{"allowed_uses":{"type":"array","items":{"type":"string"}},"commercial_eligible":{"type":"boolean"},"confidence":{"type":"number","format":"float"},"editorial_eligible":{"type":"boolean"},"evidence":{"$ref":"#/components/schemas/RightsEvidenceInfo"},"manual_review_required":{"type":"boolean"},"prohibited_uses":{"type":"array","items":{"type":"string"}},"release":{"$ref":"#/components/schemas/RightsReleaseInfo"},"rights_id":{"type":"string","format":"uuid"},"rights_status":{"type":"string"},"term":{"$ref":"#/components/schemas/RightsTermInfo"},"territory":{"$ref":"#/components/schemas/RightsTerritoryInfo"}}},"RightsReleaseInfo":{"type":"object","required":["model_release_required","model_release_present","property_release_required","property_release_present"],"properties":{"model_release_present":{"type":"boolean"},"model_release_required":{"type":"boolean"},"property_release_present":{"type":"boolean"},"property_release_required":{"type":"boolean"}}},"RightsSummary":{"type":"object","description":"Summary of rights status for an asset in search results.","required":["cleared"],"properties":{"cleared":{"type":"boolean","description":"Whether at least one cleared rights record exists."}}},"RightsTermInfo":{"type":"object","required":["within_bounds"],"properties":{"granted_end":{"type":["string","null"],"format":"date"},"granted_start":{"type":["string","null"],"format":"date"},"requested_end":{"type":["string","null"],"format":"date"},"requested_start":{"type":["string","null"],"format":"date"},"within_bounds":{"type":"boolean"}}},"RightsTerritoryInfo":{"type":"object","required":["granted","matches"],"properties":{"granted":{"type":"string"},"matches":{"type":"boolean"},"requested":{"type":["string","null"]}}},"SearchAssetResult":{"type":"object","description":"A single asset in search results.","required":["asset_id","title","description","media_type","tags","machine_ready","has_preview","manual_review_required","rights_summary","score","created_at"],"properties":{"asset_id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"duration_ms":{"type":["integer","null"],"format":"int32"},"estimated_price_cents":{"type":["integer","null"],"format":"int64"},"external_clip_id":{"type":["string","null"]},"has_preview":{"type":"boolean"},"height":{"type":["integer","null"],"format":"int32"},"machine_ready":{"type":"boolean"},"manual_review_required":{"type":"boolean"},"media_type":{"type":"string"},"original_filename":{"type":["string","null"]},"rights_summary":{"$ref":"#/components/schemas/RightsSummary"},"score":{"type":"number","format":"double"},"source_href":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}},"title":{"type":"string"},"width":{"type":["integer","null"],"format":"int32"}}},"SearchAssetsFilters":{"type":"object","description":"Filters within the search request.","properties":{"archival_classes":{"type":["array","null"],"items":{"type":"string"},"description":"Filter by archival class tags."},"categories":{"type":["array","null"],"items":{"type":"string"},"description":"Filter by category tags."},"color_modes":{"type":["array","null"],"items":{"type":"string"},"description":"Filter by color mode values: `color`, `black_and_white`."},"commercial_eligible":{"type":["boolean","null"],"description":"Filter by commercial eligibility."},"decades":{"type":["array","null"],"items":{"type":"string"},"description":"Filter by decade labels (e.g. `[\"1960s\"]`)."},"editorial_exclusion":{"type":["boolean","null"],"description":"Exclude editorial-only assets when true."},"locations":{"type":["array","null"],"items":{"type":"string"},"description":"Filter by location labels/tags."},"machine_ready":{"type":"boolean","description":"Only return machine-ready assets (default true)."},"max_duration_ms":{"type":["integer","null"],"format":"int32","description":"Maximum duration in milliseconds."},"max_height":{"type":["integer","null"],"format":"int32","description":"Maximum height in pixels."},"max_width":{"type":["integer","null"],"format":"int32","description":"Maximum width in pixels."},"media_types":{"type":["array","null"],"items":{"type":"string"},"description":"Filter by media types (e.g. `[\"video\", \"image\"]`)."},"min_duration_ms":{"type":["integer","null"],"format":"int32","description":"Minimum duration in milliseconds."},"min_height":{"type":["integer","null"],"format":"int32","description":"Minimum height in pixels."},"min_width":{"type":["integer","null"],"format":"int32","description":"Minimum width in pixels."},"price_ceiling_cents":{"type":["integer","null"],"format":"int64","description":"Optional price ceiling under filters for PRD parity."},"rights_classes":{"type":["array","null"],"items":{"type":"string"},"description":"Filter by rights classes (allowed use classes)."},"rights_cleared":{"type":"boolean","description":"Only return assets with cleared rights (default true)."},"subjects":{"type":["array","null"],"items":{"type":"string"},"description":"Filter by subject tags."},"tags":{"type":["array","null"],"items":{"type":"string"},"description":"Require ALL specified tags."},"years":{"type":["array","null"],"items":{"type":"integer","format":"int32"},"description":"Filter by exact year values (e.g. `[1963, 1969]`)."}}},"SearchAssetsRequest":{"type":"object","description":"Request body for POST /v1/search/assets.","properties":{"cursor":{"type":["string","null"],"description":"Cursor for pagination (opaque, base64-encoded offset)."},"filters":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/SearchAssetsFilters","description":"Structured filters to narrow results."}]},"image_base64":{"type":["string","null"],"description":"Optional base64-encoded image (or data URI) for live visual search mode."},"image_mime_type":{"type":["string","null"],"description":"Optional MIME type for `image_base64` payload (e.g. `image/jpeg`)."},"limit":{"type":["integer","null"],"format":"int64","description":"Maximum results per page (default 20, max 100)."},"price_ceiling_cents":{"type":["integer","null"],"format":"int64","description":"Maximum price ceiling in cents. Assets with estimated price above this\nvalue are excluded from results."},"query":{"type":["string","null"],"description":"Free-text query for full-text search."}}},"SearchAssetsResponse":{"type":"object","description":"Response for POST /v1/search/assets.","required":["results","ranking"],"properties":{"next_cursor":{"type":["string","null"]},"ranking":{"$ref":"#/components/schemas/SearchRankingInfo"},"results":{"type":"array","items":{"$ref":"#/components/schemas/SearchAssetResult"}}}},"SearchError":{"type":"object","description":"Error response body used by search endpoints.","required":["error","message"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}},"SearchRankingInfo":{"type":"object","description":"Ranking metadata in the response.","required":["method","total_results"],"properties":{"method":{"type":"string"},"total_results":{"type":"integer","minimum":0}}},"SearchSimilarRequest":{"type":"object","description":"Request body for POST /v1/search/similar.","required":["asset_id"],"properties":{"asset_id":{"type":"string","format":"uuid","description":"The seed asset ID to find similar assets for."},"cursor":{"type":["string","null"],"description":"Cursor for pagination (opaque offset)."},"filters":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/SimilarFilters","description":"Optional filters to narrow results."}]},"limit":{"type":["integer","null"],"format":"int64","description":"Maximum results per page (default 20, max 100)."}}},"SearchSimilarResponse":{"type":"object","description":"Response for POST /v1/search/similar.","required":["seed_asset_id","results","total_results"],"properties":{"next_cursor":{"type":["string","null"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/SimilarAssetResult"}},"seed_asset_id":{"type":"string","format":"uuid"},"total_results":{"type":"integer","minimum":0}}},"SimilarAssetResult":{"type":"object","description":"A single asset in similar-search results.","required":["asset_id","title","description","media_type","tags","machine_ready","has_preview","similarity_score","created_at"],"properties":{"asset_id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"description":{"type":"string"},"duration_ms":{"type":["integer","null"],"format":"int32"},"has_preview":{"type":"boolean"},"height":{"type":["integer","null"],"format":"int32"},"machine_ready":{"type":"boolean"},"media_type":{"type":"string"},"similarity_score":{"type":"number","format":"double"},"tags":{"type":"array","items":{"type":"string"}},"title":{"type":"string"},"width":{"type":["integer","null"],"format":"int32"}}},"SimilarFilters":{"type":"object","description":"Filters for similar-asset search.","properties":{"machine_ready":{"type":"boolean","description":"Only return machine-ready assets (default true)."},"media_types":{"type":["array","null"],"items":{"type":"string"},"description":"Filter by media types (e.g. `[\"video\", \"image\"]`)."},"min_height":{"type":["integer","null"],"format":"int32","description":"Minimum height in pixels."},"min_width":{"type":["integer","null"],"format":"int32","description":"Minimum width in pixels."},"rights_cleared":{"type":"boolean","description":"Only return assets with cleared rights (default true)."},"tags":{"type":["array","null"],"items":{"type":"string"},"description":"Require ALL specified tags."}}},"UpdateAutomatableRequest":{"type":"object","description":"Request body for POST /admin/v1/assets/{asset_id}/automatable.","required":["automatable","reason"],"properties":{"automatable":{"type":"boolean"},"reason":{"type":"string"}}},"UpdateVisibilityRequest":{"type":"object","description":"Request body for POST /admin/v1/assets/{asset_id}/visibility.","required":["visibility","reason"],"properties":{"reason":{"type":"string"},"visibility":{"type":"string"}}},"VerifyRightsRequest":{"type":"object","description":"Request body for POST /v1/rights/verify.","required":["asset_id","intended_use"],"properties":{"asset_id":{"type":"string","format":"uuid","description":"The asset to verify rights for."},"intended_use":{"type":"string","description":"The intended use scope (e.g. \"commercial\", \"editorial\")."},"term_end":{"type":["string","null"],"format":"date","description":"Desired license term end date."},"term_start":{"type":["string","null"],"format":"date","description":"Desired license term start date."},"territory":{"type":["string","null"],"description":"Territory for the intended use (e.g. \"US\", \"worldwide\")."}}},"VerifyRightsResponse":{"type":"object","description":"Response body for POST /v1/rights/verify.","required":["asset_id","decision","reasons"],"properties":{"asset_id":{"type":"string","format":"uuid"},"confidence":{"type":["number","null"],"format":"float","description":"Confidence from the matching rights record, if any."},"decision":{"type":"string","description":"\"eligible\", \"manual_review_required\", or \"not_eligible\"."},"matching_rights_id":{"type":["string","null"],"format":"uuid","description":"The rights record that best matches the request, if any."},"policy":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/RightsPolicyBundle","description":"Expanded rights policy payload from the best-matching rights record."}]},"reasons":{"type":"array","items":{"$ref":"#/components/schemas/PolicyReason"}}}}},"securitySchemes":{"api_key":{"type":"apiKey","in":"header","name":"Authorization"}}},"security":[{"api_key":[]}],"tags":[{"name":"Health","description":"Liveness and readiness probes"},{"name":"Discovery","description":"Machine-readable discovery and integration metadata"},{"name":"Identity","description":"Principal identity verification"},{"name":"Search","description":"Catalog search and similarity"},{"name":"Assets","description":"Asset detail and rights lookup"},{"name":"Rights","description":"Rights verification"},{"name":"Quotes","description":"Price quote creation and retrieval"},{"name":"Payments","description":"Payment intent creation"},{"name":"Licenses","description":"License execution and retrieval"},{"name":"Receipts","description":"Receipt retrieval and verification"},{"name":"Tokens","description":"Preview and download token issuance"},{"name":"Admin","description":"Admin tooling and diagnostics"}]}