{"openapi":"3.1.0","info":{"title":"Music Verification","version":"1.0.0"},"paths":{"/api/v1/agreements/current":{"get":{"tags":["legal"],"summary":"Current Agreement","operationId":"current_agreement_api_v1_agreements_current_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Current Agreement Api V1 Agreements Current Get"}}}}}}},"/api/v1/uploads/agreement":{"post":{"tags":["legal"],"summary":"Post Agreement Accept","operationId":"post_agreement_accept_api_v1_uploads_agreement_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgreementAcceptRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Post Agreement Accept Api V1 Uploads Agreement Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/uploads/song":{"post":{"tags":["uploads"],"summary":"Upload Song","operationId":"upload_song_api_v1_uploads_song_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_song_api_v1_uploads_song_post"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Upload Song Api V1 Uploads Song Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/uploads/{song_id}":{"get":{"tags":["uploads"],"summary":"Upload Status","operationId":"upload_status_api_v1_uploads__song_id__get","parameters":[{"name":"song_id","in":"path","required":true,"schema":{"type":"string","title":"Song Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Upload Status Api V1 Uploads  Song Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/songs/{song_id}":{"get":{"tags":["songs"],"summary":"Get Song","operationId":"get_song_api_v1_songs__song_id__get","parameters":[{"name":"song_id","in":"path","required":true,"schema":{"type":"string","title":"Song Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Song Api V1 Songs  Song Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/library":{"get":{"tags":["library"],"summary":"List Library","operationId":"list_library_api_v1_library_get","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"updated_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated Since"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Q"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Library Api V1 Library Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ownership/connect/{provider}":{"get":{"tags":["ownership"],"summary":"Connect","description":"Return the provider consent URL for the DJ to visit.","operationId":"connect_api_v1_ownership_connect__provider__get","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Connect Api V1 Ownership Connect  Provider  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ownership/links":{"get":{"tags":["ownership"],"summary":"List Links","operationId":"list_links_api_v1_ownership_links_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Links Api V1 Ownership Links Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/takedowns":{"post":{"tags":["takedowns"],"summary":"Submit Takedown","operationId":"submit_takedown_api_v1_takedowns_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TakedownIntakeRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Submit Takedown Api V1 Takedowns Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/disputes":{"post":{"tags":["disputes"],"summary":"Submit Dispute","operationId":"submit_dispute_api_v1_disputes_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisputeRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Submit Dispute Api V1 Disputes Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/legal/contacts":{"get":{"tags":["legal"],"summary":"List Legal Contacts","operationId":"list_legal_contacts_api_v1_legal_contacts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Legal Contacts Api V1 Legal Contacts Get"}}}}}}},"/api/v1/legal/dmca-agent":{"get":{"tags":["legal"],"summary":"Dmca Agent","operationId":"dmca_agent_api_v1_legal_dmca_agent_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Dmca Agent Api V1 Legal Dmca Agent Get"}}}}}}},"/admin/v1/cases":{"get":{"tags":["admin"],"summary":"List Cases","operationId":"list_cases_admin_v1_cases_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Cases Admin V1 Cases Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/cases/{case_id}":{"get":{"tags":["admin"],"summary":"Get Case","operationId":"get_case_admin_v1_cases__case_id__get","parameters":[{"name":"case_id","in":"path","required":true,"schema":{"type":"string","title":"Case Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Case Admin V1 Cases  Case Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/cases/{case_id}/decision":{"post":{"tags":["admin"],"summary":"Decide Case","operationId":"decide_case_admin_v1_cases__case_id__decision_post","parameters":[{"name":"case_id","in":"path","required":true,"schema":{"type":"string","title":"Case Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminCaseDecision"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Decide Case Admin V1 Cases  Case Id  Decision Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/songs/needs-review":{"get":{"tags":["admin"],"summary":"Needs Review Queue","operationId":"needs_review_queue_admin_v1_songs_needs_review_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Needs Review Queue Admin V1 Songs Needs Review Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/songs/{song_id}/internal-review/resolve":{"post":{"tags":["admin"],"summary":"Resolve Internal Review","operationId":"resolve_internal_review_admin_v1_songs__song_id__internal_review_resolve_post","parameters":[{"name":"song_id","in":"path","required":true,"schema":{"type":"string","title":"Song Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminInternalReviewResolve"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Resolve Internal Review Admin V1 Songs  Song Id  Internal Review Resolve Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/legal/contacts":{"post":{"tags":["admin"],"summary":"Publish Legal Contact","operationId":"publish_legal_contact_admin_v1_legal_contacts_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminLegalContactPublish"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Publish Legal Contact Admin V1 Legal Contacts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/settings":{"get":{"tags":["admin"],"summary":"Get Settings View","operationId":"get_settings_view_admin_v1_settings_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Settings View Admin V1 Settings Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["admin"],"summary":"Update Settings","description":"Override an operational knob at runtime (audited). Versioned engine core stays in config.","operationId":"update_settings_admin_v1_settings_patch","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSettingsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Settings Admin V1 Settings Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/agreements":{"post":{"tags":["admin"],"summary":"Publish Agreement","operationId":"publish_agreement_admin_v1_agreements_post","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishAgreementRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Publish Agreement Admin V1 Agreements Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/stats":{"get":{"tags":["admin"],"summary":"Stats","description":"Counts for the operations dashboard.","operationId":"stats_admin_v1_stats_get","parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Stats Admin V1 Stats Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/songs":{"get":{"tags":["admin"],"summary":"List Songs","description":"The full catalog with filters + search (Song ID / title / artist / ISRC).","operationId":"list_songs_admin_v1_songs_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"uploader","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uploader"}},{"name":"owner_verified","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Owner Verified"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Q"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Songs Admin V1 Songs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/songs/{song_id}":{"get":{"tags":["admin"],"summary":"Song Detail","description":"The full record of one track — everything an operator needs to decide.","operationId":"song_detail_admin_v1_songs__song_id__get","parameters":[{"name":"song_id","in":"path","required":true,"schema":{"type":"string","title":"Song Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Song Detail Admin V1 Songs  Song Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/songs/{song_id}/preview-url":{"get":{"tags":["admin"],"summary":"Admin Preview Url","description":"A signed, expiring URL to play the track in the panel — any status (admin scope).","operationId":"admin_preview_url_admin_v1_songs__song_id__preview_url_get","parameters":[{"name":"song_id","in":"path","required":true,"schema":{"type":"string","title":"Song Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Admin Preview Url Admin V1 Songs  Song Id  Preview Url Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/songs/{song_id}/status":{"post":{"tags":["admin"],"summary":"Override Status","description":"Force a song to a new status, with a mandatory audited reason.","operationId":"override_status_admin_v1_songs__song_id__status_post","parameters":[{"name":"song_id","in":"path","required":true,"schema":{"type":"string","title":"Song Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminSongStatusUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Override Status Admin V1 Songs  Song Id  Status Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/uploaders":{"get":{"tags":["admin"],"summary":"List Uploaders","description":"All uploaders with their strike/upload counters.","operationId":"list_uploaders_admin_v1_uploaders_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Limit"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Uploaders Admin V1 Uploaders Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/uploaders/{uploader_id}":{"get":{"tags":["admin"],"summary":"Uploader Detail","description":"One uploader: profile, connected creator accounts, and their recent tracks.","operationId":"uploader_detail_admin_v1_uploaders__uploader_id__get","parameters":[{"name":"uploader_id","in":"path","required":true,"schema":{"type":"string","title":"Uploader Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Uploader Detail Admin V1 Uploaders  Uploader Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/songs/{song_id}/evidence":{"get":{"tags":["admin"],"summary":"Song Evidence","description":"The sealed evidence package for a track (the legal artifact) + audio download.","operationId":"song_evidence_admin_v1_songs__song_id__evidence_get","parameters":[{"name":"song_id","in":"path","required":true,"schema":{"type":"string","title":"Song Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Song Evidence Admin V1 Songs  Song Id  Evidence Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/audit-log":{"get":{"tags":["admin"],"summary":"Audit Log","description":"Append-only log of every admin mutation (who did what, when, why).","operationId":"audit_log_admin_v1_audit_log_get","parameters":[{"name":"target_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Limit"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Audit Log Admin V1 Audit Log Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/reports/takedowns":{"get":{"tags":["admin"],"summary":"Takedown Report","description":"Takedown volume by status (DSA-style transparency reporting).","operationId":"takedown_report_admin_v1_reports_takedowns_get","parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Takedown Report Admin V1 Reports Takedowns Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/webhooks":{"get":{"tags":["admin"],"summary":"List Webhooks","description":"Outbound webhook delivery log (to the short-video app).","operationId":"list_webhooks_admin_v1_webhooks_get","parameters":[{"name":"last_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Limit"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Webhooks Admin V1 Webhooks Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/v1/webhooks/{delivery_id}/redrive":{"post":{"tags":["admin"],"summary":"Redrive Webhook","description":"Re-queue a failed/dead-lettered delivery (audited), then enqueue a send.","operationId":"redrive_webhook_admin_v1_webhooks__delivery_id__redrive_post","parameters":[{"name":"delivery_id","in":"path","required":true,"schema":{"type":"string","title":"Delivery Id"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RedriveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Redrive Webhook Admin V1 Webhooks  Delivery Id  Redrive Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AdminCaseDecision":{"properties":{"decision":{"type":"string","enum":["action_taken","rejected_as_invalid","closed"],"title":"Decision"},"manual_override_reason":{"type":"string","maxLength":1000,"minLength":10,"title":"Manual Override Reason"}},"type":"object","required":["decision","manual_override_reason"],"title":"AdminCaseDecision"},"AdminInternalReviewResolve":{"properties":{"conclusion":{"type":"string","maxLength":2000,"minLength":1,"title":"Conclusion"},"manual_override_reason":{"type":"string","maxLength":1000,"minLength":10,"title":"Manual Override Reason"}},"type":"object","required":["conclusion","manual_override_reason"],"title":"AdminInternalReviewResolve"},"AdminLegalContactPublish":{"properties":{"role":{"type":"string","title":"Role"},"jurisdiction":{"type":"string","title":"Jurisdiction"},"name":{"type":"string","title":"Name"},"email":{"type":"string","format":"email","title":"Email"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"postal_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Address"},"manual_override_reason":{"type":"string","maxLength":1000,"minLength":10,"title":"Manual Override Reason"}},"type":"object","required":["role","jurisdiction","name","email","manual_override_reason"],"title":"AdminLegalContactPublish"},"AdminSongStatusUpdate":{"properties":{"status":{"type":"string","enum":["approved","blocked","flagged_copied","copyright_claimed","disabled","pending"],"title":"Status"},"manual_override_reason":{"type":"string","maxLength":1000,"minLength":10,"title":"Manual Override Reason"}},"type":"object","required":["status","manual_override_reason"],"title":"AdminSongStatusUpdate"},"AgreementAcceptRequest":{"properties":{"agreement_version_id":{"type":"string","title":"Agreement Version Id"}},"type":"object","required":["agreement_version_id"],"title":"AgreementAcceptRequest"},"Body_upload_song_api_v1_uploads_song_post":{"properties":{"audio":{"type":"string","format":"binary","title":"Audio","description":"Audio file (mp3/wav/m4a/etc.)"},"metadata":{"type":"string","title":"Metadata","description":"JSON-encoded SongUploadMetadata"}},"type":"object","required":["audio","metadata"],"title":"Body_upload_song_api_v1_uploads_song_post"},"DisputeRequest":{"properties":{"case_id":{"type":"string","title":"Case Id"},"statement":{"type":"string","maxLength":10000,"minLength":10,"title":"Statement"},"evidence_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Evidence Url"},"swear_under_penalty":{"type":"boolean","title":"Swear Under Penalty"},"consent_to_jurisdiction":{"type":"string","maxLength":200,"minLength":1,"title":"Consent To Jurisdiction"},"signature":{"type":"string","maxLength":200,"minLength":1,"title":"Signature"},"signed_at":{"type":"string","format":"date-time","title":"Signed At"}},"type":"object","required":["case_id","statement","swear_under_penalty","consent_to_jurisdiction","signature","signed_at"],"title":"DisputeRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"PublishAgreementRequest":{"properties":{"version":{"type":"string","maxLength":32,"minLength":1,"title":"Version"},"body_md":{"type":"string","minLength":10,"title":"Body Md"},"manual_override_reason":{"type":"string","maxLength":1000,"minLength":10,"title":"Manual Override Reason"}},"type":"object","required":["version","body_md","manual_override_reason"],"title":"PublishAgreementRequest"},"RedriveRequest":{"properties":{"manual_override_reason":{"type":"string","maxLength":1000,"minLength":10,"title":"Manual Override Reason"}},"type":"object","required":["manual_override_reason"],"title":"RedriveRequest"},"TakedownIntakeRequest":{"properties":{"song_id":{"type":"string","title":"Song Id"},"claimant_name":{"type":"string","maxLength":200,"minLength":1,"title":"Claimant Name"},"claimant_email":{"type":"string","format":"email","title":"Claimant Email"},"claimant_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claimant Address"},"claimant_jurisdiction":{"type":"string","maxLength":8,"minLength":2,"title":"Claimant Jurisdiction"},"claimant_is_rights_holder":{"type":"boolean","title":"Claimant Is Rights Holder"},"claimant_agent_for":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claimant Agent For"},"claim_type":{"type":"string","enum":["copyright","trademark","defamation","other"],"title":"Claim Type","default":"copyright"},"original_work_identification":{"type":"string","maxLength":2000,"minLength":1,"title":"Original Work Identification"},"infringement_evidence_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Infringement Evidence Url"},"good_faith_statement":{"type":"boolean","title":"Good Faith Statement"},"accuracy_under_penalty_statement":{"type":"boolean","title":"Accuracy Under Penalty Statement"},"signature":{"type":"string","maxLength":200,"minLength":1,"title":"Signature"},"signed_at":{"type":"string","format":"date-time","title":"Signed At"},"captcha_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Captcha Token"}},"type":"object","required":["song_id","claimant_name","claimant_email","claimant_jurisdiction","claimant_is_rights_holder","original_work_identification","good_faith_statement","accuracy_under_penalty_statement","signature","signed_at"],"title":"TakedownIntakeRequest"},"UpdateSettingsRequest":{"properties":{"updates":{"additionalProperties":{"type":"string"},"type":"object","title":"Updates"},"manual_override_reason":{"type":"string","maxLength":1000,"minLength":10,"title":"Manual Override Reason"}},"type":"object","required":["updates","manual_override_reason"],"title":"UpdateSettingsRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}