{"openapi":"3.1.0","info":{"title":"videoworker.dev account API","description":"Private media processing through the separately owned isolated worker.","version":"0.1.0"},"paths":{"/.well-known/oauth-protected-resource/mcp/server":{"get":{"summary":"Mcp Resource Metadata","operationId":"mcp_resource_metadata__well_known_oauth_protected_resource_mcp_server_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/plans":{"get":{"summary":"Plans","operationId":"plans_v1_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/stats":{"get":{"summary":"Public Stats","operationId":"public_stats_v1_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/usage":{"get":{"summary":"Usage","operationId":"usage_v1_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"SessionCookie":[]},{"PersonalAPIKey":[]}]}},"/v1/billing/checkout":{"post":{"summary":"Checkout","operationId":"checkout_v1_billing_checkout_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]}]}},"/v1/billing/portal":{"post":{"summary":"Portal","operationId":"portal_v1_billing_portal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortalRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]}]}},"/v1/billing/webhook":{"post":{"summary":"Webhook","operationId":"webhook_v1_billing_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/admin/overview":{"get":{"summary":"Overview","operationId":"overview_v1_admin_overview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"SessionCookie":[]}]}},"/v1/admin/accounts":{"get":{"summary":"Account List","operationId":"account_list_v1_admin_accounts_get","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","maxLength":200,"default":"","title":"Query"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]}]}},"/v1/admin/jobs":{"get":{"summary":"Job List","operationId":"job_list_v1_admin_jobs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]}]}},"/v1/admin/audit":{"get":{"summary":"Audit List","operationId":"audit_list_v1_admin_audit_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]}]}},"/v1/admin/accounts/{account_id}":{"get":{"summary":"Account Detail","operationId":"account_detail_v1_admin_accounts__account_id__get","parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string","title":"Account Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]}]}},"/v1/admin/accounts/{account_id}/status":{"post":{"summary":"Status","operationId":"status_v1_admin_accounts__account_id__status_post","parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string","title":"Account Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]}]}},"/v1/admin/accounts/{account_id}/credit":{"post":{"summary":"Credit","operationId":"credit_v1_admin_accounts__account_id__credit_post","parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string","title":"Account Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]}]}},"/v1/admin/keys/{key_id}/revoke":{"post":{"summary":"Revoke","operationId":"revoke_v1_admin_keys__key_id__revoke_post","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]}]}},"/v1/admin/jobs/{job_id}/cancel":{"post":{"summary":"Cancel","operationId":"cancel_v1_admin_jobs__job_id__cancel_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]}]}},"/v1/demo":{"post":{"summary":"Bootstrap","operationId":"bootstrap_v1_demo_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/v1/demo/jobs":{"get":{"summary":"Listing","operationId":"listing_v1_demo_jobs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]},"post":{"summary":"Create","operationId":"create_v1_demo_jobs_post","responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/v1/demo/jobs/{job_id}":{"get":{"summary":"Status","operationId":"status_v1_demo_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}},"/v1/demo/jobs/{job_id}/cancel":{"post":{"summary":"Cancel","operationId":"cancel_v1_demo_jobs__job_id__cancel_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}},"/v1/demo/jobs/{job_id}/outputs/{name}":{"get":{"summary":"Download","operationId":"download_v1_demo_jobs__job_id__outputs__name__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[]}},"/v1/me":{"get":{"summary":"Me","operationId":"me_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"SessionCookie":[]},{"PersonalAPIKey":[]}]}},"/v1/api-keys":{"get":{"summary":"List Keys","operationId":"list_keys_v1_api_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"SessionCookie":[]}]},"post":{"summary":"Create Key","operationId":"create_key_v1_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]}]}},"/v1/api-keys/{key_id}":{"delete":{"summary":"Revoke Key","operationId":"revoke_key_v1_api_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]}]}},"/v1/health":{"get":{"summary":"Health","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/limits":{"get":{"summary":"Media Limits","operationId":"media_limits_v1_limits_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"SessionCookie":[]},{"PersonalAPIKey":[]}]}},"/v1/files":{"post":{"summary":"Upload","description":"Upload raw bytes, with a URL-encoded filename in X-Filename.\n\nStreaming raw uploads avoids buffering a multipart form before limits apply.","operationId":"upload_v1_files_post","parameters":[{"name":"X-Filename","in":"header","required":false,"schema":{"type":"string","description":"URL-encoded original filename","default":"input.mp4","title":"X-Filename"},"description":"URL-encoded original filename"}],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"security":[{"SessionCookie":[]},{"PersonalAPIKey":[]}]}},"/v1/jobs":{"post":{"summary":"Submit","operationId":"submit_v1_jobs_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Account-scoped admission UUID. Reuse with identical JSON for safe retries for 48 hours. Changed payload: 409; original job expired: 410.","title":"Idempotency-Key"},"description":"Account-scoped admission UUID. Reuse with identical JSON for safe retries for 48 hours. Changed payload: 409; original job expired: 410."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]},{"PersonalAPIKey":[]}]},"get":{"summary":"Recent Jobs","operationId":"recent_jobs_v1_jobs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"SessionCookie":[]},{"PersonalAPIKey":[]}]}},"/v1/demo-file":{"post":{"summary":"Demo File","operationId":"demo_file_v1_demo_file_post","responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"SessionCookie":[]},{"PersonalAPIKey":[]}]}},"/v1/jobs/{job_id}":{"get":{"summary":"Status","operationId":"status_v1_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]},{"PersonalAPIKey":[]}]}},"/v1/jobs/{job_id}/cancel":{"post":{"summary":"Cancel","operationId":"cancel_v1_jobs__job_id__cancel_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]},{"PersonalAPIKey":[]}]}},"/v1/jobs/{job_id}/outputs":{"delete":{"summary":"Delete Outputs","operationId":"delete_outputs_v1_jobs__job_id__outputs_delete","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"202":{"description":"Removal requested; poll until outputs_delete_pending is false and outputs_deleted_at is set"},"409":{"description":"Job is still active"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]},{"PersonalAPIKey":[]}]}},"/v1/jobs/{job_id}/outputs/{name}":{"get":{"summary":"Download","operationId":"download_v1_jobs__job_id__outputs__name__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"SessionCookie":[]},{"PersonalAPIKey":[]}]}},"/":{"get":{"summary":"Index","operationId":"index__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ActionRequest":{"properties":{"reason":{"type":"string","maxLength":1000,"minLength":1,"title":"Reason"},"idempotency_key":{"type":"string","format":"uuid","title":"Idempotency Key"}},"additionalProperties":false,"type":"object","required":["reason","idempotency_key"],"title":"ActionRequest"},"CheckoutRequest":{"properties":{"plan":{"type":"string","const":"monthly","title":"Plan"},"idempotency_key":{"type":"string","format":"uuid","title":"Idempotency Key"}},"additionalProperties":false,"type":"object","required":["plan","idempotency_key"],"title":"CheckoutRequest"},"CreditRequest":{"properties":{"reason":{"type":"string","maxLength":1000,"minLength":1,"title":"Reason"},"idempotency_key":{"type":"string","format":"uuid","title":"Idempotency Key"},"seconds":{"type":"integer","maximum":86400.0,"exclusiveMinimum":0.0,"title":"Seconds"}},"additionalProperties":false,"type":"object","required":["reason","idempotency_key","seconds"],"title":"CreditRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"JobRequest":{"properties":{"inputs":{"items":{"type":"string"},"type":"array","maxItems":4,"minItems":1,"title":"Inputs"},"args":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":3,"title":"Args"},"outputs":{"items":{"type":"string"},"type":"array","maxItems":4,"minItems":1,"title":"Outputs"},"timeout_seconds":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Timeout Seconds"}},"type":"object","required":["inputs","args","outputs"],"title":"JobRequest"},"KeyRequest":{"properties":{"label":{"type":"string","maxLength":80,"minLength":1,"title":"Label"},"scopes":{"items":{"type":"string"},"type":"array","maxItems":5,"minItems":1,"title":"Scopes"}},"type":"object","required":["label","scopes"],"title":"KeyRequest"},"PortalRequest":{"properties":{},"additionalProperties":false,"type":"object","title":"PortalRequest"},"StatusRequest":{"properties":{"reason":{"type":"string","maxLength":1000,"minLength":1,"title":"Reason"},"idempotency_key":{"type":"string","format":"uuid","title":"Idempotency Key"},"status":{"type":"string","enum":["active","suspended"],"title":"Status"}},"additionalProperties":false,"type":"object","required":["reason","idempotency_key","status"],"title":"StatusRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"SessionCookie":{"type":"apiKey","in":"cookie","name":"__Secure-better-auth.session_token","description":"Verified Better Auth session. Writes also require the configured Origin and X-CSRF-Token from /v1/me. HTTPS uses the library's __Secure- cookie prefix."},"PersonalAPIKey":{"type":"http","scheme":"bearer","description":"Personal key with required workload scope; cannot manage keys or grant admin permissions."}}}}