{"components":{"schemas":{"AgentCapabilitiesResponse":{"additionalProperties":true,"properties":{"capability_fingerprint":{"type":"string"},"client_configs":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"conformance_profiles":{"items":{"type":"string"},"type":"array"},"default_model_id":{"type":"string"},"minimum_client_versions":{"additionalProperties":{"type":"string"},"type":"object"},"model_ids":{"items":{"type":"string"},"type":"array"},"object":{"const":"agent_capabilities","type":"string"},"orchestration":{"additionalProperties":true,"type":"object"},"resumable_turns":{"additionalProperties":true,"type":"object"},"schema_version":{"type":"integer"},"streaming":{"additionalProperties":true,"type":"object"},"tool_calls":{"additionalProperties":true,"type":"object"},"urls":{"additionalProperties":{"type":"string"},"type":"object"}},"required":["object","schema_version","capability_fingerprint","urls"],"type":"object"},"AgentClientConfigFreshnessResponse":{"additionalProperties":true,"properties":{"client":{"enum":["opencode","hermes"],"type":"string"},"fingerprint":{"type":"string"},"fresh":{"type":"boolean"},"object":{"const":"agent_client_config_freshness","type":"string"},"refresh_recommended":{"type":"boolean"},"selected_model_id":{"type":"string"}},"required":["object","client","fresh","refresh_recommended"],"type":"object"},"AgentClientConfigResponse":{"additionalProperties":true,"properties":{"client":{"enum":["opencode","hermes"],"type":"string"},"config":{"additionalProperties":true,"type":"object"},"install_hints":{"items":{"type":"string"},"type":"array"},"object":{"const":"agent_client_config","type":"string"},"redacted_config":{"additionalProperties":true,"type":"object"},"validation":{"additionalProperties":true,"properties":{"fingerprint":{"type":"string"},"freshness_url":{"type":"string"},"selected_model_id":{"type":"string"}},"type":"object"}},"required":["object","client","config","validation"],"type":"object"},"AgentToolBatchPlanRequest":{"additionalProperties":true,"properties":{"client":{"type":"string"},"schema_version":{"type":"integer"},"tool_calls":{"items":{"additionalProperties":true,"properties":{"function":{"additionalProperties":true,"properties":{"arguments":{"type":"string"},"name":{"type":"string"}},"required":["name","arguments"],"type":"object"},"id":{"type":"string"},"type":{"const":"function","type":"string"}},"required":["id","type","function"],"type":"object"},"type":"array"},"workspace_policy":{"type":"string"}},"required":["schema_version","tool_calls"],"type":"object"},"AgentToolBatchPlanResponse":{"additionalProperties":true,"properties":{"decisions":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"groups":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"object":{"const":"agent_tool_batch_plan","type":"string"},"schema_version":{"type":"integer"}},"required":["object","schema_version","groups","decisions"],"type":"object"},"AgentTurnCreateRequest":{"additionalProperties":true,"properties":{"messages":{"items":{"type":"object"},"type":"array"},"metadata":{"$ref":"#/components/schemas/PublicRequestMetadata"},"model":{"description":"Use one of the launch public model IDs.","enum":["ipop/coder-balanced","claude-sonnet-4.6","grok-build-0.1","step-3.7-flash","claude-opus-4.8-fast","claude-opus-4.8","openai/gpt-5.5","openai/gpt-5.4","grok-4.3","gemini-3.5-flash","qwen3.7-max","openai/gpt-5.4-mini","deepseek-v4-pro","qwen3-235b-a22b-thinking-2507","openai/gpt-5-nano","gemini-3.1-flash-lite","kimi-k2.6","deepseek-v4-flash","mistral-small-2603","codestral-2508","ling-2.6-flash"],"examples":["ipop/coder-balanced","grok-build-0.1","deepseek-v4-flash"],"type":"string"},"response_format":{},"stream":{"default":true,"type":"boolean"},"tool_choice":{},"tools":{"items":{"type":"object"},"type":"array"}},"required":["model","messages"],"type":"object"},"AgentTurnResponse":{"additionalProperties":true,"properties":{"cancel_url":{"type":"string"},"detail_url":{"type":"string"},"events_url":{"type":"string"},"full_event_replay_available":{"type":"boolean"},"latest_event_seq":{"type":"integer"},"lifecycle":{"enum":["queued","warming","running","streaming","tooling","cancel_requested","completed","failed","canceled"],"type":"string"},"model":{"type":"string"},"object":{"const":"agent_turn","type":"string"},"replay_url":{"type":"string"},"request_history_url":{"type":"string"},"request_id":{"type":"string"},"retry_after_seconds":{"type":"integer"},"retryable":{"type":"boolean"}},"required":["object","request_id","lifecycle"],"type":"object"},"AppTelemetryCatalog":{"additionalProperties":false,"properties":{"entitlement":{"$ref":"#/components/schemas/AppTelemetryEntitlement"},"event_units":{"additionalProperties":{"type":"integer"},"type":"object"},"generated_at_unix":{"type":"integer"},"object":{"const":"app_telemetry.catalog","type":"string"},"plans":{"items":{"$ref":"#/components/schemas/AppTelemetryPlan"},"type":"array"},"plugin_id":{"const":"app-telemetry","type":"string"},"recommended_plan_id":{"type":"string"},"source_map_free_mb":{"type":"integer"},"unit_rate_usd":{"type":"number"}},"required":["object","plugin_id","generated_at_unix","recommended_plan_id","entitlement","plans","event_units","source_map_free_mb","unit_rate_usd"],"type":"object"},"AppTelemetryEntitlement":{"additionalProperties":false,"properties":{"beta_default_enabled":{"type":"boolean"},"flag":{"const":"app_telemetry","type":"string"},"paid_gate_enabled":{"type":"boolean"}},"required":["flag","beta_default_enabled","paid_gate_enabled"],"type":"object"},"AppTelemetryEnvelope":{"additionalProperties":true,"properties":{"events":{"items":{"$ref":"#/components/schemas/AppTelemetryEvent"},"maxItems":100,"type":"array"},"object":{"const":"app_telemetry.envelope","type":"string"},"resource":{"additionalProperties":true,"type":"object"},"sdk":{"additionalProperties":true,"type":"object"}},"required":["object","events"],"type":"object"},"AppTelemetryEvent":{"additionalProperties":true,"properties":{"attributes":{"additionalProperties":true,"type":"object"},"breadcrumbs":{"items":{},"type":"array"},"exception":{"additionalProperties":true,"type":"object"},"message":{"type":"string"},"name":{"type":"string"},"session_id":{"type":"string"},"span_id":{"type":"string"},"timestamp":{"format":"date-time","type":"string"},"trace_id":{"type":"string"},"type":{"enum":["error","event","page_view","session","log","span"],"type":"string"},"user":{"additionalProperties":true,"type":"object"}},"required":["type"],"type":"object"},"AppTelemetryIngestResult":{"additionalProperties":false,"properties":{"accepted_events":{"type":"integer"},"billed_units":{"type":"integer"},"free_units":{"type":"integer"},"object":{"const":"app_telemetry.ingest_result","type":"string"},"rejected_events":{"type":"integer"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["object","accepted_events","rejected_events","free_units","billed_units","warnings"],"type":"object"},"AppTelemetryPlan":{"additionalProperties":false,"properties":{"features":{"items":{"type":"string"},"type":"array"},"id":{"type":"string"},"included_units":{"type":"integer"},"monthly_usd":{"type":["number","null"]},"name":{"type":"string"},"overage_unit_rate_usd":{"type":"number"},"summary":{"type":"string"}},"required":["id","name","monthly_usd","included_units","overage_unit_rate_usd","summary","features"],"type":"object"},"AppTelemetrySourceMap":{"additionalProperties":true,"properties":{"artifact_name":{"type":"string"},"billed_units":{"type":"integer"},"compressed_bytes":{"type":"integer"},"content_type":{"type":"string"},"cost_usd":{"type":"number"},"created_at":{"format":"date-time","type":"string"},"file_name":{"type":"string"},"id":{"type":"string"},"org_id":{"type":"string"},"original_bytes":{"type":"integer"},"release":{"type":"string"}},"required":["id","org_id","release","artifact_name","file_name","original_bytes","compressed_bytes","billed_units","cost_usd","created_at"],"type":"object"},"AppTelemetrySourceMapUpload":{"additionalProperties":false,"properties":{"artifact_name":{"type":"string"},"content_base64":{"type":"string"},"content_type":{"type":"string"},"file_name":{"type":"string"},"release":{"type":"string"}},"required":["release","artifact_name","file_name","content_base64"],"type":"object"},"AppTelemetryUsage":{"additionalProperties":false,"properties":{"billed_units":{"type":"integer"},"cost_usd":{"type":"number"},"error_count":{"type":"integer"},"event_count":{"type":"integer"},"free_limit_units":{"type":"integer"},"free_units":{"type":"integer"},"month_utc":{"type":"string"},"object":{"const":"app_telemetry.usage","type":"string"},"org_id":{"type":"string"},"total_units":{"type":"integer"}},"required":["object","org_id","month_utc","free_limit_units","total_units","free_units","billed_units","cost_usd","event_count","error_count"],"type":"object"},"AttachVectorStoreFileRequest":{"additionalProperties":true,"properties":{"file_id":{"description":"Id of a file previously uploaded via POST /v1/files with `purpose=assistants`.","type":"string"}},"required":["file_id"],"type":"object"},"AudioTranscriptionJsonResponse":{"additionalProperties":true,"properties":{"text":{"type":"string"}},"required":["text"],"type":"object"},"AudioTranscriptionVerboseResponse":{"additionalProperties":true,"properties":{"duration":{"format":"double","type":"number"},"language":{"nullable":true,"type":"string"},"segments":{"items":{"additionalProperties":true,"properties":{"avg_logprob":{"format":"double","nullable":true,"type":"number"},"compression_ratio":{"format":"double","nullable":true,"type":"number"},"end":{"format":"double","type":"number"},"id":{"type":"integer"},"no_speech_prob":{"format":"double","nullable":true,"type":"number"},"seek":{"type":"integer"},"start":{"format":"double","type":"number"},"temperature":{"format":"float","nullable":true,"type":"number"},"text":{"type":"string"},"tokens":{"items":{"type":"integer"},"type":"array"}},"required":["id","seek","start","end","text"],"type":"object"},"type":"array"},"task":{"description":"Always \"transcribe\" for /audio/transcriptions.","type":"string"},"text":{"type":"string"},"words":{"items":{"additionalProperties":true,"properties":{"end":{"format":"double","type":"number"},"start":{"format":"double","type":"number"},"word":{"type":"string"}},"required":["word","start","end"],"type":"object"},"type":"array"}},"required":["task","duration","text"],"type":"object"},"BatchDetailResponse":{"allOf":[{"$ref":"#/components/schemas/BatchJob"},{"properties":{"rows":{"items":{"$ref":"#/components/schemas/BatchJobRow"},"type":"array"}},"required":["rows"],"type":"object"}]},"BatchJob":{"additionalProperties":true,"properties":{"cancel_requested_at":{"format":"date-time","nullable":true,"type":"string"},"completed_at":{"format":"date-time","nullable":true,"type":"string"},"completion_window_secs":{"minimum":1,"type":"integer"},"created_at":{"format":"date-time","type":"string"},"deadline_at":{"format":"date-time","type":"string"},"endpoint":{"enum":["chat_completions","embeddings"],"type":"string"},"error_file_id":{"nullable":true,"type":"string"},"id":{"type":"string"},"input_file_id":{"type":"string"},"last_error":{"nullable":true,"type":"string"},"metadata":{"additionalProperties":true,"nullable":true,"type":"object"},"output_file_id":{"nullable":true,"type":"string"},"owner_user_id":{"type":"string"},"project_id":{"nullable":true,"type":"string"},"request_counts":{"properties":{"completed":{"minimum":0,"type":"integer"},"failed":{"minimum":0,"type":"integer"},"total":{"minimum":0,"type":"integer"}},"required":["total","completed","failed"],"type":"object"},"reserved_credit_total":{"nullable":true,"type":"number"},"started_at":{"format":"date-time","nullable":true,"type":"string"},"status":{"enum":["validating","in_progress","finalizing","completed","failed","expired","cancelling","cancelled"],"type":"string"}},"required":["id","owner_user_id","status","endpoint","input_file_id","request_counts","completion_window_secs","created_at","deadline_at"],"type":"object"},"BatchJobRow":{"additionalProperties":true,"properties":{"batch_id":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"custom_id":{"nullable":true,"type":"string"},"error":{"additionalProperties":true,"nullable":true,"type":"object"},"output_line":{"nullable":true,"type":"string"},"request_id":{"format":"uuid","nullable":true,"type":"string"},"row_index":{"minimum":0,"type":"integer"},"status":{"enum":["pending","queued","running","completed","failed","cancelled"],"type":"string"},"updated_at":{"format":"date-time","nullable":true,"type":"string"}},"required":["batch_id","row_index","status","created_at"],"type":"object"},"BatchListResponse":{"additionalProperties":true,"properties":{"data":{"items":{"$ref":"#/components/schemas/BatchJob"},"type":"array"},"object":{"const":"list","type":"string"}},"required":["object","data"],"type":"object"},"BoxAdminHealth":{"additionalProperties":false,"properties":{"backend":{"enum":["disabled","sqlite","postgres"],"type":"string"},"enabled":{"type":"boolean"},"failed_documents":{"type":"integer"},"failed_jobs":{"type":"integer"},"fresh_worker_count":{"type":"integer"},"indexed_documents":{"type":"integer"},"leased_jobs":{"type":"integer"},"object":{"const":"box.admin_health","type":"string"},"oldest_leased_age_seconds":{"type":["integer","null"]},"oldest_queued_age_seconds":{"type":["integer","null"]},"oldest_retry_age_seconds":{"type":["integer","null"]},"oldest_stale_lease_age_seconds":{"type":["integer","null"]},"oldest_worker_heartbeat_age_seconds":{"type":["integer","null"]},"queued_jobs":{"type":"integer"},"recent_chat_failures":{"type":"integer"},"recent_embedding_failures":{"type":"integer"},"recent_failures_by_stage":{"additionalProperties":{"type":"integer"},"type":"object"},"retrying_jobs":{"type":"integer"},"stale_leased_jobs":{"type":"integer"},"storage_mode":{"enum":["disabled","local","object_storage"],"type":"string"},"worker_count":{"type":"integer"},"workers":{"items":{"$ref":"#/components/schemas/BoxWorkerHealth"},"type":"array"}},"required":["object","enabled","backend","queued_jobs","leased_jobs","retrying_jobs","failed_jobs","stale_leased_jobs","indexed_documents","failed_documents","worker_count","fresh_worker_count","recent_embedding_failures","recent_chat_failures","storage_mode","workers","recent_failures_by_stage"],"type":"object"},"BoxAdminReadiness":{"additionalProperties":false,"properties":{"alerts":{"items":{"$ref":"#/components/schemas/BoxReadinessAlert"},"type":"array"},"backend":{"enum":["disabled","sqlite","postgres"],"type":"string"},"config":{"additionalProperties":false,"properties":{"api_base_url_configured":{"type":"boolean"},"required":{"items":{"$ref":"#/components/schemas/BoxReadinessConfigItem"},"type":"array"},"worker_token_configured":{"type":"boolean"}},"required":["required","worker_token_configured","api_base_url_configured"],"type":"object"},"documents":{"additionalProperties":false,"properties":{"failed_documents":{"type":"integer"},"indexed_documents":{"type":"integer"}},"required":["indexed_documents","failed_documents"],"type":"object"},"enabled":{"type":"boolean"},"metrics":{"additionalProperties":false,"properties":{"available":{"type":"boolean"},"expected_series":{"items":{"type":"string"},"type":"array"}},"required":["available","expected_series"],"type":"object"},"object":{"const":"box.admin_readiness","type":"string"},"queue":{"additionalProperties":false,"properties":{"failed_jobs":{"type":"integer"},"leased_jobs":{"type":"integer"},"oldest_leased_age_seconds":{"type":["integer","null"]},"oldest_queued_age_seconds":{"type":["integer","null"]},"oldest_retry_age_seconds":{"type":["integer","null"]},"oldest_stale_lease_age_seconds":{"type":["integer","null"]},"queued_jobs":{"type":"integer"},"recent_chat_failures":{"type":"integer"},"recent_embedding_failures":{"type":"integer"},"recent_failures_by_stage":{"additionalProperties":{"type":"integer"},"type":"object"},"retrying_jobs":{"type":"integer"},"stale_leased_jobs":{"type":"integer"}},"required":["queued_jobs","leased_jobs","retrying_jobs","failed_jobs","stale_leased_jobs","recent_embedding_failures","recent_chat_failures","recent_failures_by_stage"],"type":"object"},"ready":{"type":"boolean"},"runbook_links":{"items":{"additionalProperties":false,"properties":{"href":{"type":"string"},"label":{"type":"string"}},"required":["label","href"],"type":"object"},"type":"array"},"smoke":{"additionalProperties":false,"properties":{"local_smoke_requires_rich_formats":{"type":"boolean"},"project_id_env_supported":{"type":"boolean"},"project_selection":{"const":"automatic","type":"string"},"rich_formats_required_for_prod_gate":{"type":"boolean"},"txt_required":{"type":"boolean"}},"required":["project_selection","txt_required","rich_formats_required_for_prod_gate","project_id_env_supported","local_smoke_requires_rich_formats"],"type":"object"},"storage_mode":{"enum":["disabled","local","object_storage"],"type":"string"},"tools":{"additionalProperties":false,"properties":{"fresh_worker_tools":{"items":{"$ref":"#/components/schemas/BoxWorkerToolReport"},"type":"array"},"libreoffice_available":{"type":"boolean"},"pdftotext_available":{"type":"boolean"},"txt_supported":{"type":"boolean"}},"required":["pdftotext_available","libreoffice_available","txt_supported","fresh_worker_tools"],"type":"object"},"workers":{"additionalProperties":false,"properties":{"fresh":{"type":"integer"},"oldest_heartbeat_age_seconds":{"type":["integer","null"]},"stale":{"type":"integer"},"total":{"type":"integer"},"workers":{"items":{"$ref":"#/components/schemas/BoxWorkerHealth"},"type":"array"}},"required":["total","fresh","stale","workers"],"type":"object"}},"required":["object","ready","enabled","backend","storage_mode","config","workers","tools","queue","documents","metrics","smoke","alerts","runbook_links"],"type":"object"},"BoxBinaryResponse":{"description":"Raw Project Box source document bytes.","format":"binary","type":"string"},"BoxChunkDetail":{"additionalProperties":false,"properties":{"chunk":{"$ref":"#/components/schemas/BoxRetrievedChunk"},"document":{"$ref":"#/components/schemas/BoxDocument"},"object":{"const":"box.chunk","type":"string"}},"required":["object","document","chunk"],"type":"object"},"BoxCitation":{"additionalProperties":false,"properties":{"chunk_id":{"type":"string"},"chunk_index":{"type":"integer"},"document_id":{"type":"string"},"document_name":{"type":"string"},"page":{"type":["string","null"]},"sheet":{"type":["string","null"]},"slide":{"type":["integer","null"]},"source_end":{"type":["integer","null"]},"source_start":{"type":["integer","null"]}},"required":["document_id","document_name","chunk_id","chunk_index"],"type":"object"},"BoxDocument":{"additionalProperties":false,"properties":{"chunk_count":{"type":"integer"},"created_at":{"format":"date-time","type":"string"},"error":{"type":["string","null"]},"filename":{"type":"string"},"id":{"type":"string"},"indexed_at":{"format":"date-time","type":["string","null"]},"mime_type":{"type":"string"},"project_id":{"type":"string"},"size_bytes":{"type":"integer"},"source_hash":{"type":"string"},"status":{"enum":["queued","indexing","indexed","failed","deleted"],"type":"string"},"updated_at":{"format":"date-time","type":"string"}},"required":["id","project_id","filename","mime_type","size_bytes","source_hash","status","chunk_count","created_at","updated_at"],"type":"object"},"BoxDocumentCreateResponse":{"additionalProperties":false,"properties":{"document":{"$ref":"#/components/schemas/BoxDocument"},"duplicate":{"type":"boolean"},"object":{"const":"box.document_create","type":"string"}},"required":["object","document","duplicate"],"type":"object"},"BoxDocumentDetail":{"additionalProperties":false,"properties":{"document":{"$ref":"#/components/schemas/BoxDocument"},"jobs":{"items":{"$ref":"#/components/schemas/BoxJob"},"type":"array"},"object":{"const":"box.document_detail","type":"string"}},"required":["object","document","jobs"],"type":"object"},"BoxDocumentUploadRequest":{"additionalProperties":false,"properties":{"content_base64":{"contentEncoding":"base64","type":"string"},"filename":{"type":"string"},"mime_type":{"type":"string"}},"required":["filename","content_base64"],"type":"object"},"BoxJob":{"additionalProperties":false,"properties":{"attempts":{"type":"integer"},"created_at":{"format":"date-time","type":"string"},"document_id":{"type":"string"},"error":{"type":["string","null"]},"heartbeat_at":{"format":"date-time","type":["string","null"]},"id":{"type":"string"},"kind":{"type":"string"},"lease_expires_at":{"format":"date-time","type":["string","null"]},"lease_owner":{"type":["string","null"]},"max_attempts":{"type":"integer"},"project_id":{"type":"string"},"run_after":{"format":"date-time","type":"string"},"status":{"type":"string"},"updated_at":{"format":"date-time","type":"string"}},"required":["id","document_id","project_id","kind","status","attempts","max_attempts","run_after","created_at","updated_at"],"type":"object"},"BoxLimits":{"additionalProperties":false,"properties":{"max_chunks_per_document":{"type":"integer"},"max_documents_per_project":{"type":"integer"},"max_file_bytes":{"type":"integer"},"retrieval_top_k":{"type":"integer"},"supported_file_types":{"items":{"type":"string"},"type":"array"}},"required":["max_file_bytes","max_documents_per_project","max_chunks_per_document","retrieval_top_k","supported_file_types"],"type":"object"},"BoxPublicWorkerStatus":{"additionalProperties":false,"properties":{"configured":{"type":"boolean"},"fresh":{"type":"boolean"},"state":{"enum":["disabled","missing","stale","fresh"],"type":"string"}},"required":["configured","state","fresh"],"type":"object"},"BoxQueryHistoryItem":{"additionalProperties":false,"properties":{"answer":{"type":"string"},"cost_usd":{"type":"number"},"created_at":{"format":"date-time","type":"string"},"id":{"type":"string"},"model_id":{"type":"string"},"question":{"type":"string"},"retrieved_chunk_count":{"type":"integer"},"total_tokens":{"type":"integer"}},"required":["id","question","answer","retrieved_chunk_count","model_id","total_tokens","cost_usd","created_at"],"type":"object"},"BoxQueryRequest":{"additionalProperties":false,"properties":{"model":{"description":"Use one of the launch public model IDs.","enum":["ipop/coder-balanced","claude-sonnet-4.6","grok-build-0.1","step-3.7-flash","claude-opus-4.8-fast","claude-opus-4.8","openai/gpt-5.5","openai/gpt-5.4","grok-4.3","gemini-3.5-flash","qwen3.7-max","openai/gpt-5.4-mini","deepseek-v4-pro","qwen3-235b-a22b-thinking-2507","openai/gpt-5-nano","gemini-3.1-flash-lite","kimi-k2.6","deepseek-v4-flash","mistral-small-2603","codestral-2508","ling-2.6-flash"],"examples":["ipop/coder-balanced","grok-build-0.1","deepseek-v4-flash"],"type":"string"},"question":{"type":"string"},"top_k":{"maximum":50,"minimum":1,"type":"integer"}},"required":["question"],"type":"object"},"BoxQueryResponse":{"additionalProperties":false,"properties":{"answer":{"type":"string"},"citations":{"items":{"$ref":"#/components/schemas/BoxCitation"},"type":"array"},"created_at":{"format":"date-time","type":"string"},"id":{"type":"string"},"object":{"const":"box.query","type":"string"},"retrieved_chunks":{"items":{"$ref":"#/components/schemas/BoxRetrievedChunk"},"type":"array"},"usage":{"$ref":"#/components/schemas/BoxQueryUsage"}},"required":["object","id","answer","citations","retrieved_chunks","usage","created_at"],"type":"object"},"BoxQueryUsage":{"additionalProperties":false,"properties":{"chat_cost_usd":{"type":"number"},"chat_latency_ms":{"type":"integer"},"chat_model":{"type":"string"},"completion_tokens":{"type":"integer"},"cost_usd":{"type":"number"},"embedding_cost_usd":{"type":"number"},"embedding_latency_ms":{"type":"integer"},"embedding_model":{"type":"string"},"embedding_tokens":{"type":"integer"},"latency_ms":{"type":"integer"},"prompt_tokens":{"type":"integer"},"route_metadata":{"additionalProperties":true,"type":"object"},"total_tokens":{"type":"integer"}},"required":["embedding_model","chat_model","embedding_tokens","prompt_tokens","completion_tokens","total_tokens","cost_usd","latency_ms"],"type":"object"},"BoxReadinessAlert":{"additionalProperties":false,"properties":{"action":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"severity":{"enum":["critical","warning","info"],"type":"string"}},"required":["severity","code","message","action"],"type":"object"},"BoxReadinessConfigItem":{"additionalProperties":false,"properties":{"configured":{"type":"boolean"},"name":{"type":"string"},"required":{"type":"boolean"}},"required":["name","configured","required"],"type":"object"},"BoxRetrievedChunk":{"additionalProperties":false,"properties":{"chunk_index":{"type":"integer"},"citation":{"$ref":"#/components/schemas/BoxCitation"},"document_id":{"type":"string"},"document_name":{"type":"string"},"id":{"type":"string"},"metadata":{"type":"object"},"score":{"type":"number"},"text":{"type":"string"},"token_count":{"type":"integer"}},"required":["id","document_id","document_name","chunk_index","text","score","token_count","citation"],"type":"object"},"BoxSummary":{"additionalProperties":false,"properties":{"documents":{"items":{"$ref":"#/components/schemas/BoxDocument"},"type":"array"},"enabled":{"type":"boolean"},"limits":{"$ref":"#/components/schemas/BoxLimits"},"object":{"const":"box.summary","type":"string"},"project_id":{"type":"string"},"recent_queries":{"items":{"$ref":"#/components/schemas/BoxQueryHistoryItem"},"type":"array"},"usage":{"$ref":"#/components/schemas/BoxUsage"},"worker_status":{"$ref":"#/components/schemas/BoxPublicWorkerStatus"}},"required":["object","project_id","enabled","limits","usage","documents","recent_queries"],"type":"object"},"BoxToolProbe":{"additionalProperties":false,"properties":{"available":{"type":"boolean"},"error":{"type":"string"},"path":{"type":"string"},"version":{"type":"string"}},"required":["available"],"type":"object"},"BoxUsage":{"additionalProperties":false,"properties":{"chunk_count":{"type":"integer"},"document_count":{"type":"integer"},"embedding_tokens":{"type":"integer"},"extracted_bytes":{"type":"integer"},"failed_documents":{"type":"integer"},"indexed_documents":{"type":"integer"},"last_indexed_at":{"format":"date-time","type":["string","null"]},"query_count":{"type":"integer"},"query_tokens":{"type":"integer"},"storage_bytes":{"type":"integer"},"total_cost_usd":{"type":"number"}},"required":["document_count","storage_bytes","indexed_documents","failed_documents","chunk_count","extracted_bytes","embedding_tokens","query_count","query_tokens","total_cost_usd"],"type":"object"},"BoxWorkerHealth":{"additionalProperties":false,"properties":{"active_job_id":{"type":["string","null"]},"fresh":{"type":"boolean"},"heartbeat_age_seconds":{"type":"integer"},"last_heartbeat_at":{"format":"date-time","type":"string"},"status":{"type":"string"},"tools":{"$ref":"#/components/schemas/BoxWorkerToolReport"},"worker_id":{"type":"string"}},"required":["worker_id","status","fresh","last_heartbeat_at","heartbeat_age_seconds","tools"],"type":"object"},"BoxWorkerToolReport":{"additionalProperties":false,"properties":{"libreoffice":{"$ref":"#/components/schemas/BoxToolProbe"},"pdftotext":{"$ref":"#/components/schemas/BoxToolProbe"}},"required":["pdftotext","libreoffice"],"type":"object"},"ChatCompletionRequest":{"additionalProperties":true,"properties":{"max_completion_tokens":{"minimum":1,"type":"integer"},"max_tokens":{"minimum":1,"type":"integer"},"messages":{"items":{"type":"object"},"type":"array"},"metadata":{"$ref":"#/components/schemas/PublicRequestMetadata"},"model":{"description":"Use one of the launch public model IDs.","enum":["ipop/coder-balanced","claude-sonnet-4.6","grok-build-0.1","step-3.7-flash","claude-opus-4.8-fast","claude-opus-4.8","openai/gpt-5.5","openai/gpt-5.4","grok-4.3","gemini-3.5-flash","qwen3.7-max","openai/gpt-5.4-mini","deepseek-v4-pro","qwen3-235b-a22b-thinking-2507","openai/gpt-5-nano","gemini-3.1-flash-lite","kimi-k2.6","deepseek-v4-flash","mistral-small-2603","codestral-2508","ling-2.6-flash"],"examples":["ipop/coder-balanced","grok-build-0.1","deepseek-v4-flash"],"type":"string"},"reasoning_effort":{"enum":["low","medium","high","xhigh"],"type":"string"},"response_format":{},"service_tier":{"enum":["standard","priority"],"type":"string"},"stream":{"default":false,"type":"boolean"},"temperature":{"type":"number"},"tool_choice":{},"tools":{"items":{"type":"object"},"type":"array"}},"required":["model","messages"],"type":"object"},"ChatCompletionResponse":{"additionalProperties":false,"properties":{"choices":{"items":{"type":"object"},"type":"array"},"created":{"type":"integer"},"id":{"type":"string"},"ipop":{"$ref":"#/components/schemas/IpopMetadata"},"model":{"type":"string"},"object":{"type":"string"},"usage":{"$ref":"#/components/schemas/Usage"}},"required":["id","object","created","model","choices","usage","ipop"],"type":"object"},"CodingOptimizationAlert":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"severity":{"type":"string"},"title":{"type":"string"}},"type":"object"},"CodingOptimizationEndpointBucket":{"properties":{"apply_requests":{"type":"integer"},"average_latency_ms":{"type":["number","null"]},"endpoint":{"type":"string"},"prompt_cache_auto_requests":{"type":"integer"},"prompt_cache_off_requests":{"type":"integer"},"request_count":{"type":"integer"},"semantic_retrieval_context_bytes":{"type":"integer"},"semantic_retrieval_requests":{"type":"integer"}},"required":["endpoint","request_count","prompt_cache_auto_requests","prompt_cache_off_requests","semantic_retrieval_requests","semantic_retrieval_context_bytes","apply_requests"],"type":"object"},"CodingOptimizationNamedCount":{"properties":{"count":{"type":"integer"},"name":{"type":"string"}},"required":["name","count"],"type":"object"},"CodingOptimizationProviderBucket":{"properties":{"average_latency_ms":{"type":["number","null"]},"cache_creation_input_tokens":{"type":"integer"},"cached_input_tokens":{"type":"integer"},"cached_token_ratio":{"type":"number"},"input_tokens":{"type":"integer"},"provider":{"type":"string"},"request_count":{"type":"integer"}},"required":["provider","request_count","input_tokens","cached_input_tokens","cache_creation_input_tokens","cached_token_ratio"],"type":"object"},"CodingOptimizationRecommendation":{"properties":{"area":{"type":"string"},"detail":{"type":"string"},"priority":{"type":"string"},"title":{"type":"string"}},"type":"object"},"CodingOptimizationRepoBucket":{"properties":{"apply_requests":{"type":"integer"},"average_latency_ms":{"type":["number","null"]},"cached_token_ratio":{"type":"number"},"read_file_cache_hit_ratio":{"type":"number"},"repo_id_hash":{"type":"string"},"request_count":{"type":"integer"},"semantic_retrieval_context_bytes":{"type":"integer"}},"type":"object"},"CodingOptimizationSessionBucket":{"properties":{"apply_requests":{"type":"integer"},"average_latency_ms":{"type":["number","null"]},"cached_token_ratio":{"type":"number"},"context_cleaner_bytes_saved":{"type":"integer"},"read_file_cache_hit_ratio":{"type":"number"},"request_count":{"type":"integer"},"session_id":{"type":"string"}},"type":"object"},"CodingOptimizationSummary":{"properties":{"agent_regret_kind_counts":{"items":{"$ref":"#/components/schemas/CodingOptimizationNamedCount"},"type":"array"},"alerts":{"items":{"$ref":"#/components/schemas/CodingOptimizationAlert"},"type":"array"},"apply_failure_class_counts":{"items":{"$ref":"#/components/schemas/CodingOptimizationNamedCount"},"type":"array"},"apply_requests":{"type":"integer"},"average_apply_latency_ms":{"type":["number","null"]},"average_semantic_retrieval_context_bytes":{"type":["number","null"]},"average_verification_affinity_confidence":{"type":["number","null"]},"blocked_verification_rerun_count":{"type":"integer"},"bucket_seconds":{"type":"integer"},"by_endpoint":{"items":{"$ref":"#/components/schemas/CodingOptimizationEndpointBucket"},"type":"array"},"by_provider":{"items":{"$ref":"#/components/schemas/CodingOptimizationProviderBucket"},"type":"array"},"by_repo":{"items":{"$ref":"#/components/schemas/CodingOptimizationRepoBucket"},"type":"array"},"by_session":{"items":{"$ref":"#/components/schemas/CodingOptimizationSessionBucket"},"type":"array"},"cli_apply_model_diff_repair_requests":{"type":"integer"},"cli_apply_model_diff_requests":{"type":"integer"},"cli_apply_model_fallback_rewrites":{"type":"integer"},"cli_apply_model_requests":{"type":"integer"},"cli_apply_model_successes":{"type":"integer"},"cli_average_apply_model_latency_ms":{"type":["number","null"]},"coding_requests":{"type":"integer"},"command_env_memory_hits":{"type":"integer"},"context_cleaner_bytes_saved":{"type":"integer"},"context_summary_bytes_saved":{"type":"integer"},"context_summary_kind_counts":{"items":{"$ref":"#/components/schemas/CodingOptimizationNamedCount"},"type":"array"},"diagnostic_count":{"type":"integer"},"diagnostic_kind_counts":{"items":{"$ref":"#/components/schemas/CodingOptimizationNamedCount"},"type":"array"},"diagnostic_path_count":{"type":"integer"},"edit_noop_count":{"type":"integer"},"edit_risk_level_counts":{"items":{"$ref":"#/components/schemas/CodingOptimizationNamedCount"},"type":"array"},"fact_ledger_bytes":{"type":"integer"},"fact_reuse_count":{"type":"integer"},"failed_apply_requests":{"type":"integer"},"failure_hint_class_counts":{"items":{"$ref":"#/components/schemas/CodingOptimizationNamedCount"},"type":"array"},"filters":{"additionalProperties":true,"type":"object"},"generated_at_unix":{"type":"integer"},"intent_shape_counts":{"items":{"$ref":"#/components/schemas/CodingOptimizationNamedCount"},"type":"array"},"loop_stop_kind_counts":{"items":{"$ref":"#/components/schemas/CodingOptimizationNamedCount"},"type":"array"},"max_edit_risk_score":{"type":"integer"},"max_patch_preview_score":{"type":"integer"},"multi_agent_conflict_count":{"type":"integer"},"multi_agent_edit_worker_count":{"type":"integer"},"object":{"const":"admin.coding_optimization","type":"string"},"patch_preview_level_counts":{"items":{"$ref":"#/components/schemas/CodingOptimizationNamedCount"},"type":"array"},"prefetch_bytes":{"type":"integer"},"prefetch_cache_hits":{"type":"integer"},"prefetch_reason_counts":{"items":{"$ref":"#/components/schemas/CodingOptimizationNamedCount"},"type":"array"},"prefetch_tool_count":{"type":"integer"},"prevented_extra_turn_count":{"type":"integer"},"previous_window":{"additionalProperties":true,"type":"object"},"prompt_cache_auto_requests":{"type":"integer"},"prompt_cache_key_requests":{"type":"integer"},"prompt_cache_off_requests":{"type":"integer"},"provider_cache_creation_input_tokens":{"type":"integer"},"provider_cached_input_tokens":{"type":"integer"},"provider_cached_token_ratio":{"type":"number"},"provider_input_tokens":{"type":"integer"},"read_file_cache_hit_ratio":{"type":"number"},"read_file_cache_hits":{"type":"integer"},"read_file_cache_misses":{"type":"integer"},"read_file_unchanged_markers":{"type":"integer"},"recommendations":{"items":{"$ref":"#/components/schemas/CodingOptimizationRecommendation"},"type":"array"},"repair_hint_count":{"type":"integer"},"retrieval_reason_counts":{"items":{"$ref":"#/components/schemas/CodingOptimizationNamedCount"},"type":"array"},"semantic_edit_plan_count":{"type":"integer"},"semantic_edit_plan_rejected_count":{"type":"integer"},"semantic_index_chunk_count":{"type":"integer"},"semantic_index_fallback_embedding_chunks":{"type":"integer"},"semantic_index_indexed_file_count":{"type":"integer"},"semantic_index_latest_refresh_unix_secs":{"type":["integer","null"]},"semantic_index_stale_file_count":{"type":"integer"},"semantic_retrieval_chunks":{"type":"integer"},"semantic_retrieval_context_bytes":{"type":"integer"},"semantic_retrieval_requests":{"type":"integer"},"stop_policy_kind_counts":{"items":{"$ref":"#/components/schemas/CodingOptimizationNamedCount"},"type":"array"},"successful_apply_requests":{"type":"integer"},"total_requests":{"type":"integer"},"trends":{"items":{"$ref":"#/components/schemas/CodingOptimizationTrendBucket"},"type":"array"},"uninspected_edit_path_count":{"type":"integer"},"verification_affinity_uses":{"type":"integer"},"verification_cost_model_uses":{"type":"integer"},"verification_cost_saved_ms":{"type":"integer"},"verification_plan_kind_counts":{"items":{"$ref":"#/components/schemas/CodingOptimizationNamedCount"},"type":"array"},"window_seconds":{"type":"integer"}},"required":["object","generated_at_unix","window_seconds","total_requests","coding_requests","provider_input_tokens","provider_cached_input_tokens","provider_cache_creation_input_tokens","provider_cached_token_ratio","prompt_cache_auto_requests","prompt_cache_off_requests","prompt_cache_key_requests","semantic_retrieval_requests","semantic_retrieval_chunks","semantic_retrieval_context_bytes","apply_requests","successful_apply_requests","failed_apply_requests","by_provider","by_endpoint"],"type":"object"},"CodingOptimizationTrendBucket":{"properties":{"apply_success_ratio":{"type":"number"},"average_latency_ms":{"type":["number","null"]},"coding_requests":{"type":"integer"},"context_cleaner_bytes_saved":{"type":"integer"},"provider_cached_token_ratio":{"type":"number"},"read_file_cache_hit_ratio":{"type":"number"},"request_count":{"type":"integer"},"semantic_retrieval_context_bytes":{"type":"integer"},"started_at_unix":{"type":"integer"}},"type":"object"},"ContentCapturePolicy":{"additionalProperties":false,"properties":{"max_chars_per_message":{"minimum":1,"type":"integer"},"mode":{"enum":["off","sampled","all"],"type":"string"},"redact":{"type":"boolean"},"redaction_rule_id":{"type":["string","null"]},"retention_days":{"minimum":1,"type":"integer"},"sample_rate":{"maximum":1.0,"minimum":0.0,"type":"number"}},"required":["mode","sample_rate","retention_days","redact","max_chars_per_message"],"type":"object"},"CreateAudioSpeechRequest":{"additionalProperties":true,"properties":{"input":{"maxLength":4096,"type":"string"},"model":{"description":"Catalog model id (e.g. `terminaili/tts`).","type":"string"},"response_format":{"default":"mp3","enum":["mp3","opus","aac","flac","wav","pcm"],"type":"string"},"speed":{"default":1.0,"maximum":4.0,"minimum":0.25,"type":"number"},"voice":{"enum":["alloy","echo","fable","onyx","nova","shimmer"],"type":"string"}},"required":["model","input","voice"],"type":"object"},"CreateBatchRequest":{"additionalProperties":true,"properties":{"completion_window":{"default":"24h","description":"Max time to keep this batch running, e.g. '24h', '30m', '600s'. Max 7d.","type":"string"},"endpoint":{"default":"chat_completions","enum":["chat_completions","embeddings"],"type":"string"},"input_file_id":{"description":"File id returned by POST /v1/files with purpose=batch.","type":"string"},"metadata":{"additionalProperties":true,"type":"object"}},"required":["input_file_id"],"type":"object"},"CreateFineTuneJobRequest":{"additionalProperties":true,"properties":{"backend":{"description":"Required training backend. Scheduler refuses nodes that don't advertise it.","enum":["mlx_lora","cuda_lora"],"type":"string"},"hyperparameters":{"$ref":"#/components/schemas/FineTuneHyperparameters"},"metadata":{"additionalProperties":true,"nullable":true,"type":"object"},"model":{"description":"Base model catalog id. Must be active and trainable.","type":"string"},"result_visibility":{"default":"user","description":"Where the resulting ft: model is visible. `project` requires a project-scoped API key.","enum":["user","project"],"type":"string"},"seed":{"description":"Random seed for the training run; fixes data shuffling and dropout.","minimum":0,"nullable":true,"type":"integer"},"suffix":{"description":"User-supplied slug appended to the resulting fine-tune model id.","nullable":true,"type":"string"},"training_file":{"description":"File id from POST /v1/files with purpose=fine-tune. Each line: a chat-format JSON object with a `messages` array.","type":"string"},"validation_file":{"description":"Optional held-out file with purpose=fine-tune-validation.","nullable":true,"type":"string"}},"required":["training_file","model"],"type":"object"},"CreateVectorStoreRequest":{"additionalProperties":true,"properties":{"embedding_model":{"description":"Optional override; default `terminaili/embed-balanced`.","type":"string"},"expires_at":{"format":"date-time","type":"string"},"metadata":{"additionalProperties":true,"type":"object"},"name":{"maxLength":128,"type":"string"}},"required":["name"],"type":"object"},"EmbeddingsRequest":{"additionalProperties":true,"properties":{"dimensions":{"minimum":1,"type":"integer"},"encoding_format":{"enum":["float","base64"],"type":"string"},"input":{"oneOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"metadata":{"$ref":"#/components/schemas/PublicRequestMetadata"},"model":{"description":"Use one of the launch public model IDs.","enum":["ipop/coder-balanced","claude-sonnet-4.6","grok-build-0.1","step-3.7-flash","claude-opus-4.8-fast","claude-opus-4.8","openai/gpt-5.5","openai/gpt-5.4","grok-4.3","gemini-3.5-flash","qwen3.7-max","openai/gpt-5.4-mini","deepseek-v4-pro","qwen3-235b-a22b-thinking-2507","openai/gpt-5-nano","gemini-3.1-flash-lite","kimi-k2.6","deepseek-v4-flash","mistral-small-2603","codestral-2508","ling-2.6-flash"],"examples":["ipop/coder-balanced","grok-build-0.1","deepseek-v4-flash"],"type":"string"}},"required":["model","input"],"type":"object"},"EmbeddingsResponse":{"additionalProperties":false,"properties":{"created":{"type":"integer"},"data":{"items":{"type":"object"},"type":"array"},"id":{"type":"string"},"ipop":{"$ref":"#/components/schemas/IpopMetadata"},"model":{"type":"string"},"object":{"type":"string"},"usage":{"$ref":"#/components/schemas/Usage"}},"required":["id","object","created","model","data","usage","ipop"],"type":"object"},"Error":{"additionalProperties":false,"properties":{"code":{"enum":["bad_request","capacity_unavailable","context_length_exceeded","model_not_allowed","model_unavailable","payment_required","policy_violation","rate_limit_exceeded","service_unavailable","unauthorized"],"type":"string"},"error":{"type":"string"},"error_type":{"type":"string"},"message":{"type":"string"},"param":{"type":"string"},"request_id":{"type":"string"},"retry_after_seconds":{"type":"integer"},"retryable":{"type":"boolean"}},"required":["error","code","request_id","retryable"],"type":"object"},"EstimateRequest":{"additionalProperties":false,"properties":{"input":{"oneOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"max_completion_tokens":{"minimum":1,"type":"integer"},"max_tokens":{"minimum":1,"type":"integer"},"messages":{"items":{"type":"object"},"type":"array"},"metadata":{"$ref":"#/components/schemas/PublicRequestMetadata"},"model":{"description":"Use one of the launch public model IDs.","enum":["ipop/coder-balanced","claude-sonnet-4.6","grok-build-0.1","step-3.7-flash","claude-opus-4.8-fast","claude-opus-4.8","openai/gpt-5.5","openai/gpt-5.4","grok-4.3","gemini-3.5-flash","qwen3.7-max","openai/gpt-5.4-mini","deepseek-v4-pro","qwen3-235b-a22b-thinking-2507","openai/gpt-5-nano","gemini-3.1-flash-lite","kimi-k2.6","deepseek-v4-flash","mistral-small-2603","codestral-2508","ling-2.6-flash"],"examples":["ipop/coder-balanced","grok-build-0.1","deepseek-v4-flash"],"type":"string"}},"required":["model"],"type":"object"},"EstimateResponse":{"additionalProperties":false,"properties":{"estimated_completion_tokens":{"type":"integer"},"estimated_cost_usd":{"type":"number"},"estimated_prompt_tokens":{"type":"integer"},"estimated_total_tokens":{"type":"integer"},"input_token_rate":{"type":"number"},"ipop":{"$ref":"#/components/schemas/IpopMetadata"},"kind":{"enum":["chat","embeddings"],"type":"string"},"max_input_tokens":{"type":"integer"},"max_output_tokens":{"type":"integer"},"model":{"type":"string"},"object":{"const":"ipop.estimate","type":"string"},"output_token_rate":{"type":"number"},"pricing":{"$ref":"#/components/schemas/ProviderCostBreakdown"},"warnings":{"items":{"type":"string"},"type":"array"},"within_context_window":{"type":"boolean"}},"required":["object","model","kind","estimated_prompt_tokens","estimated_completion_tokens","estimated_total_tokens","estimated_cost_usd","input_token_rate","output_token_rate","within_context_window","ipop"],"type":"object"},"FileListResponse":{"additionalProperties":true,"properties":{"data":{"items":{"$ref":"#/components/schemas/FileObject"},"type":"array"},"object":{"const":"list","type":"string"}},"required":["object","data"],"type":"object"},"FileObject":{"additionalProperties":true,"properties":{"bytes":{"minimum":0,"type":"integer"},"created_at":{"format":"date-time","type":"string"},"expires_at":{"format":"date-time","nullable":true,"type":"string"},"filename":{"nullable":true,"type":"string"},"id":{"type":"string"},"object_kind":{"enum":["file"],"type":"string"},"owner_user_id":{"type":"string"},"project_id":{"nullable":true,"type":"string"},"purpose":{"enum":["batch","batch_output","batch_error","fine-tune","fine-tune-validation"],"type":"string"},"sha256":{"type":"string"},"storage_uri":{"type":"string"}},"required":["id","owner_user_id","purpose","bytes","sha256","storage_uri","created_at"],"type":"object"},"FineTuneHyperparameters":{"additionalProperties":true,"properties":{"batch_size":{"minimum":1,"type":"integer"},"learning_rate":{"description":"Adam learning rate. Default 1e-4.","minimum":0,"type":"number"},"lora_alpha":{"default":16,"description":"Terminaili-specific: LoRA alpha (scaling factor).","minimum":1,"type":"integer"},"lora_rank":{"default":8,"description":"Terminaili-specific: LoRA rank (controls adapter capacity).","minimum":1,"type":"integer"},"n_epochs":{"default":3,"description":"Passes through the training set.","minimum":1,"type":"integer"}},"type":"object"},"FineTuneJob":{"additionalProperties":true,"properties":{"backend":{"enum":["mlx_lora","cuda_lora"],"type":"string"},"base_model_id":{"type":"string"},"cancel_requested_at":{"format":"date-time","nullable":true,"type":"string"},"created_at":{"format":"date-time","type":"string"},"finished_at":{"format":"date-time","nullable":true,"type":"string"},"gpu_seconds":{"description":"Compute-time billed for the run via the `training_gpu_seconds` meter.","nullable":true,"type":"number"},"hyperparameters":{"$ref":"#/components/schemas/FineTuneHyperparameters"},"id":{"type":"string"},"last_error":{"nullable":true,"type":"string"},"metadata":{"additionalProperties":true,"nullable":true,"type":"object"},"owner_user_id":{"type":"string"},"project_id":{"nullable":true,"type":"string"},"reserved_credit_total":{"description":"Estimated credit cost reserved at submit-time. Released or settled at terminal state.","nullable":true,"type":"number"},"result_adapter_file_id":{"description":"Set on success: the uploaded LoRA adapter file id.","nullable":true,"type":"string"},"result_model_id":{"description":"Set on success: invokable via /v1/chat/completions.","nullable":true,"type":"string"},"result_visibility":{"enum":["user","project"],"type":"string"},"seed":{"nullable":true,"type":"integer"},"started_at":{"format":"date-time","nullable":true,"type":"string"},"status":{"enum":["validating_files","queued","running","succeeded","failed","cancelled"],"type":"string"},"suffix":{"nullable":true,"type":"string"},"training_file_id":{"type":"string"},"training_loss":{"nullable":true,"type":"number"},"validation_file_id":{"nullable":true,"type":"string"},"validation_loss":{"nullable":true,"type":"number"}},"required":["id","owner_user_id","status","base_model_id","training_file_id","hyperparameters","backend","result_visibility","created_at"],"type":"object"},"FineTuneJobListResponse":{"additionalProperties":true,"properties":{"data":{"items":{"$ref":"#/components/schemas/FineTuneJob"},"type":"array"},"object":{"const":"list","type":"string"}},"required":["object","data"],"type":"object"},"ImageGenerationRequest":{"additionalProperties":true,"properties":{"image_config":{"additionalProperties":true,"description":"Optional OpenRouter image_config passthrough.","type":"object"},"image_url":{"description":"Optional reference image URL or base64 data URL.","type":"string"},"image_urls":{"description":"Optional reference image URLs or base64 data URLs.","items":{"type":"string"},"maxItems":8,"type":"array"},"model":{"default":"grok-imagine-image-quality","enum":["grok-imagine-image-quality","x-ai/grok-imagine-image-quality"],"type":"string"},"n":{"default":1,"maximum":4,"minimum":1,"type":"integer"},"prompt":{"type":"string"},"quality":{"description":"Optional quality hint. `hd`, `high`, or `2k` maps to image_config.image_size=2K; standard/1k maps to 1K.","type":"string"},"response_format":{"default":"url","enum":["url","b64_json"],"type":"string"},"size":{"description":"Optional OpenAI-style WIDTHxHEIGHT size. Converted to OpenRouter image_config.aspect_ratio.","type":"string"}},"required":["prompt"],"type":"object"},"ImageGenerationResponse":{"additionalProperties":true,"properties":{"created":{"type":"integer"},"data":{"items":{"additionalProperties":true,"properties":{"b64_json":{"type":"string"},"mime_type":{"type":"string"},"revised_prompt":{"type":"string"},"url":{"type":"string"}},"type":"object"},"type":"array"},"usage":{"additionalProperties":true,"type":"object"}},"required":["created","data"],"type":"object"},"InferenceContentPolicyOverride":{"properties":{"policy":{"$ref":"#/components/schemas/ContentCapturePolicy"},"project_id":{"type":"string"},"updated_at":{"format":"date-time","type":"string"},"updated_by":{"type":"string"}},"required":["project_id","policy","updated_by","updated_at"],"type":"object"},"InferenceContentPolicySummary":{"properties":{"global":{"$ref":"#/components/schemas/ContentCapturePolicy"},"project_overrides":{"items":{"$ref":"#/components/schemas/InferenceContentPolicyOverride"},"type":"array"}},"required":["global"],"type":"object"},"InferenceErrorClassCount":{"properties":{"count":{"type":"integer"},"error_class":{"type":"string"}},"required":["error_class","count"],"type":"object"},"InferenceEvent":{"properties":{"actor_id":{"type":"string"},"actor_type":{"enum":["user","node","admin","system"],"type":"string"},"attrs":{"$ref":"#/components/schemas/InferenceEventAttrs"},"event_seq":{"minimum":1,"type":"integer"},"id":{"format":"uuid","type":"string"},"kind":{"enum":["submitted","assigned","started","first_progress","progress_tick","completed","failed","canceled","expired","requeued","dedupe_hit","dedupe_shadow","verification_started","verification_completed","content_captured"],"type":"string"},"model":{"type":["string","null"]},"node_id":{"format":"uuid","type":["string","null"]},"occurred_at":{"format":"date-time","type":"string"},"project_id":{"type":["string","null"]},"request_id":{"format":"uuid","type":"string"},"user_id":{"type":"string"}},"required":["id","request_id","event_seq","kind","occurred_at","actor_type","actor_id","user_id"],"type":"object"},"InferenceEventAttrs":{"description":"Typed attributes attached to an InferenceEvent. All fields optional; presence depends on event kind.","properties":{"cancellation_reason":{"type":["string","null"]},"cost":{"type":["number","null"]},"dedupe_path":{"enum":["exact_cache","inflight_shadow",null],"type":["string","null"]},"dedupe_source_request_id":{"format":"uuid","type":["string","null"]},"error_class":{"type":["string","null"]},"error_message":{"type":["string","null"]},"extra":{"additionalProperties":true,"type":"object"},"finish_reason":{"enum":["stop","length","tool_calls","content_filter","function_call",null],"type":["string","null"]},"latency_split":{"$ref":"#/components/schemas/InferenceLatencySplit"},"node_fault":{"type":["boolean","null"]},"phase":{"type":["string","null"]},"progress_seq":{"type":["integer","null"]},"queue_reason":{"type":["string","null"]},"requeue_reason":{"type":["string","null"]},"sample_rate":{"type":["number","null"]},"token_details":{"$ref":"#/components/schemas/InferenceTokenUsageDetails"},"tokens_in":{"type":["integer","null"]},"tokens_out":{"type":["integer","null"]},"verification_state":{"type":["string","null"]}},"type":"object"},"InferenceEventBucket":{"properties":{"count":{"type":"integer"},"hour_unix":{"type":"integer"}},"required":["hour_unix","count"],"type":"object"},"InferenceEventListResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/InferenceEvent"},"type":"array"},"next_cursor":{"type":["string","null"]}},"required":["events"],"type":"object"},"InferenceEventQuery":{"properties":{"cursor":{"type":["string","null"]},"kinds":{"items":{"type":"string"},"type":"array"},"limit":{"maximum":500,"minimum":1,"type":["integer","null"]},"model":{"type":["string","null"]},"occurred_at_from":{"format":"date-time","type":["string","null"]},"occurred_at_to":{"format":"date-time","type":["string","null"]},"project_id":{"type":["string","null"]},"request_id":{"format":"uuid","type":["string","null"]},"user_id":{"type":["string","null"]}},"type":"object"},"InferenceFeedbackListResponse":{"properties":{"feedback":{"items":{"$ref":"#/components/schemas/InferenceFeedbackRow"},"type":"array"},"request_id":{"type":"string"}},"required":["request_id","feedback"],"type":"object"},"InferenceFeedbackRow":{"properties":{"created_at_unix":{"type":"integer"},"model":{"type":"string"},"notes":{"type":["string","null"]},"outcome":{"type":["string","null"]},"project_id":{"type":["string","null"]},"rating":{"maximum":1,"minimum":-1,"type":["integer","null"]},"request_id":{"type":"string"},"task_type":{"type":["string","null"]},"user_id":{"type":"string"}},"required":["request_id","user_id","model","created_at_unix"],"type":"object"},"InferenceKindCount":{"properties":{"count":{"type":"integer"},"kind":{"type":"string"}},"required":["kind","count"],"type":"object"},"InferenceLatencySplit":{"additionalProperties":false,"properties":{"decode_ms":{"minimum":0,"type":["integer","null"]},"decode_tokens_per_second":{"type":["number","null"]},"first_progress_ms":{"minimum":0,"type":["integer","null"]},"prepare_ms":{"minimum":0,"type":["integer","null"]},"queue_ms":{"minimum":0,"type":["integer","null"]},"total_ms":{"minimum":0,"type":["integer","null"]}},"type":"object"},"InferenceMessage":{"properties":{"content":{"type":"string"},"content_parts":{},"content_truncated":{"type":"boolean"},"created_at":{"format":"date-time","type":"string"},"endpoint":{"type":["string","null"]},"execution_model_id":{"type":["string","null"]},"kind":{"enum":["request","response"],"type":"string"},"message_seq":{"minimum":1,"type":"integer"},"model":{"type":["string","null"]},"payload_available":{"type":"boolean"},"project_id":{"type":["string","null"]},"provider":{"type":["string","null"]},"raw_json":{},"redaction":{"properties":{"fields_redacted":{"items":{"type":"string"},"type":"array"},"rule_id":{"type":"string"}},"type":["object","null"]},"request_id":{"format":"uuid","type":"string"},"response_format":{},"role":{"enum":["system","developer","user","assistant","tool","function"],"type":"string"},"route_type":{"type":["string","null"]},"tokens":{"type":["integer","null"]},"tool_call_id":{"type":["string","null"]},"tool_calls":{},"tools":{}},"required":["request_id","message_seq","kind","role","content","created_at"],"type":"object"},"InferenceMessagesResponse":{"properties":{"capture_mode":{"enum":["off","sampled","all"],"type":"string"},"messages":{"items":{"$ref":"#/components/schemas/InferenceMessage"},"type":"array"},"payloads":{"items":{"$ref":"#/components/schemas/InferencePayload"},"type":"array"},"raw_payloads_available":{"type":"boolean"},"redact":{"type":"boolean"},"request_id":{"format":"uuid","type":"string"},"retention_days":{"type":"integer"}},"required":["request_id","messages"],"type":"object"},"InferencePayload":{"properties":{"created_at":{"format":"date-time","type":"string"},"endpoint":{"type":["string","null"]},"execution_model_id":{"type":["string","null"]},"kind":{"enum":["request","response"],"type":"string"},"model":{"type":["string","null"]},"payload":{},"payload_seq":{"minimum":1,"type":"integer"},"project_id":{"type":["string","null"]},"provider":{"type":["string","null"]},"request_id":{"format":"uuid","type":"string"},"route_type":{"type":["string","null"]}},"required":["request_id","payload_seq","kind","payload","created_at"],"type":"object"},"InferenceSearchHit":{"properties":{"kind":{"enum":["request","response"],"type":"string"},"message_seq":{"type":"integer"},"model":{"type":["string","null"]},"occurred_at":{"format":"date-time","type":"string"},"project_id":{"type":["string","null"]},"request_id":{"format":"uuid","type":"string"},"role":{"type":"string"},"score":{"type":"number"},"snippet":{"description":"Server-rendered HTML snippet with <mark> tags around matches.","type":"string"}},"required":["request_id","message_seq","role","kind","occurred_at","score","snippet"],"type":"object"},"InferenceSearchQuery":{"properties":{"cursor":{"type":["string","null"]},"kind":{"enum":["request","response",null],"type":["string","null"]},"limit":{"maximum":200,"minimum":1,"type":["integer","null"]},"model":{"type":["string","null"]},"occurred_at_from":{"format":"date-time","type":["string","null"]},"occurred_at_to":{"format":"date-time","type":["string","null"]},"project_id":{"type":["string","null"]},"q":{"minLength":1,"type":"string"},"role":{"type":["string","null"]}},"required":["q"],"type":"object"},"InferenceSearchResponse":{"properties":{"hits":{"items":{"$ref":"#/components/schemas/InferenceSearchHit"},"type":"array"},"next_cursor":{"type":["string","null"]}},"required":["hits"],"type":"object"},"InferenceStatsResponse":{"properties":{"captured_messages":{"type":"integer"},"events_by_kind":{"items":{"$ref":"#/components/schemas/InferenceKindCount"},"type":"array"},"events_per_hour":{"items":{"$ref":"#/components/schemas/InferenceEventBucket"},"type":"array"},"feedback_records":{"type":"integer"},"project_overrides":{"type":"integer"},"top_error_classes":{"items":{"$ref":"#/components/schemas/InferenceErrorClassCount"},"type":"array"},"total_events":{"type":"integer"},"window_hours":{"type":"integer"}},"required":["window_hours","total_events","captured_messages","feedback_records","events_by_kind","events_per_hour","top_error_classes","project_overrides"],"type":"object"},"InferenceStream":{"additionalProperties":false,"properties":{"api_surface":{"enum":["chat_completions","responses"],"type":"string"},"assigned_node_id":{"type":["string","null"]},"bytes_sent":{"minimum":0,"type":"integer"},"cancel_on_disconnect":{"type":"boolean"},"content_delta_count":{"minimum":0,"type":"integer"},"current_request_id":{"type":"string"},"event_count":{"minimum":0,"type":"integer"},"fallback_count":{"minimum":0,"type":"integer"},"instance_id":{"type":"string"},"last_event_at":{"format":"date-time","type":"string"},"last_event_kind":{"type":"string"},"model":{"type":"string"},"project_id":{"type":["string","null"]},"provider":{"type":"string"},"replayed":{"type":"boolean"},"request_id":{"type":"string"},"selected_model":{"type":"string"},"started_at":{"format":"date-time","type":"string"},"status":{"type":"string"},"stream_id":{"type":"string"},"tool_delta_count":{"minimum":0,"type":"integer"},"user_id":{"type":"string"}},"required":["stream_id","instance_id","api_surface","request_id","current_request_id","user_id","model","selected_model","provider","started_at","last_event_at","last_event_kind","status","event_count","bytes_sent","content_delta_count","tool_delta_count","replayed","cancel_on_disconnect","fallback_count"],"type":"object"},"InferenceStreamsResponse":{"additionalProperties":false,"properties":{"generated_at":{"format":"date-time","type":"string"},"instance_id":{"type":"string"},"object":{"const":"admin.inference_streams","type":"string"},"replica_count":{"minimum":1,"type":"integer"},"stream_active":{"minimum":0,"type":"integer"},"stream_available":{"minimum":0,"type":"integer"},"stream_limit":{"minimum":0,"type":"integer"},"streams":{"items":{"$ref":"#/components/schemas/InferenceStream"},"type":"array"}},"required":["object","generated_at","instance_id","replica_count","stream_limit","stream_active","stream_available","streams"],"type":"object"},"InferenceTimelineResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/InferenceEvent"},"type":"array"},"request_id":{"format":"uuid","type":"string"}},"required":["request_id","events"],"type":"object"},"InferenceTokenUsageDetails":{"additionalProperties":false,"properties":{"cached_input_tokens":{"minimum":0,"type":["integer","null"]},"reasoning_tokens":{"minimum":0,"type":["integer","null"]},"total_tokens":{"minimum":0,"type":["integer","null"]}},"type":"object"},"IpopMetadata":{"additionalProperties":false,"properties":{"cache_hit":{"type":"boolean"},"cost_usd":{"type":"number"},"estimated_cost_usd":{"type":"number"},"external_fallback_after_ms":{"type":"integer"},"fallback_count":{"type":"integer"},"fallback_reason":{"enum":["h100_no_capacity","h100_admission_failed","h100_first_progress_timeout","h100_terminal_failure","external_after_h100_grace"],"type":"string"},"fallback_used":{"type":"boolean"},"latency_ms":{"type":"integer"},"primary_first_progress_ms":{"type":"integer"},"primary_route_attempted":{"type":"boolean"},"primary_route_model":{"type":"string"},"primary_route_request_id":{"type":"string"},"region":{"type":"string"},"request_id":{"type":"string"},"route_class":{"enum":["cache","ipop_network","regional_capacity","external_capacity"],"type":"string"}},"required":["request_id","latency_ms","cost_usd","cache_hit"],"type":"object"},"KvFreeTier":{"additionalProperties":false,"properties":{"egress_bytes_per_month":{"type":"integer"},"ingress_bytes_per_month":{"type":"integer"},"storage_bytes":{"type":"integer"},"tables":{"const":1,"type":"integer"}},"required":["tables","storage_bytes","ingress_bytes_per_month","egress_bytes_per_month"],"type":"object"},"KvItem":{"additionalProperties":false,"properties":{"content_type":{"type":["string","null"]},"created_at":{"format":"date-time","type":"string"},"expires_at":{"format":"date-time","type":["string","null"]},"key":{"type":"string"},"mode":{"enum":["json","bytes"],"type":"string"},"object":{"const":"kv.item","type":"string"},"storage_bytes":{"type":"integer"},"table_id":{"const":"default","type":"string"},"updated_at":{"format":"date-time","type":"string"},"value":{},"value_base64":{"contentEncoding":"base64","type":"string"},"version":{"type":"integer"}},"required":["object","table_id","key","mode","version","storage_bytes","created_at","updated_at"],"type":"object"},"KvList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/KvItem"},"type":"array"},"next_cursor":{"type":["string","null"]},"object":{"const":"kv.list","type":"string"},"table_id":{"const":"default","type":"string"}},"required":["object","table_id","data"],"type":"object"},"KvPutRequest":{"additionalProperties":false,"oneOf":[{"required":["value"]},{"required":["value_base64"]}],"properties":{"content_type":{"maxLength":256,"type":"string"},"create_only":{"default":false,"type":"boolean"},"if_version":{"minimum":1,"type":"integer"},"key":{"examples":["projects/proj_123/settings/theme"],"maxLength":512,"minLength":1,"type":"string"},"table":{"const":"default","type":"string"},"ttl_seconds":{"maximum":31536000,"minimum":1,"type":"integer"},"value":{},"value_base64":{"contentEncoding":"base64","type":"string"}},"required":["key"],"type":"object"},"KvRateCard":{"additionalProperties":false,"properties":{"currency":{"const":"usd","type":"string"},"egress_usd_per_gb":{"type":"number"},"ingress_usd_per_gb":{"type":"number"},"operation_usd":{"const":0,"type":"number"},"storage_usd_per_gb_month":{"type":"number"}},"required":["currency","storage_usd_per_gb_month","ingress_usd_per_gb","egress_usd_per_gb","operation_usd"],"type":"object"},"KvSummary":{"additionalProperties":false,"properties":{"free_tier":{"$ref":"#/components/schemas/KvFreeTier"},"object":{"const":"kv.summary","type":"string"},"rate_card":{"$ref":"#/components/schemas/KvRateCard"},"table":{"$ref":"#/components/schemas/KvTable"},"usage":{"$ref":"#/components/schemas/KvUsage"}},"required":["object","table","usage","free_tier","rate_card"],"type":"object"},"KvTable":{"additionalProperties":false,"properties":{"billing_blocked":{"type":"boolean"},"created_at":{"format":"date-time","type":"string"},"item_count":{"type":"integer"},"last_storage_billed_at":{"format":"date-time","type":["string","null"]},"object":{"const":"kv.table","type":"string"},"storage_bytes":{"type":"integer"},"table_id":{"const":"default","type":"string"},"updated_at":{"format":"date-time","type":"string"}},"required":["object","table_id","item_count","storage_bytes","billing_blocked","created_at","updated_at"],"type":"object"},"KvUsage":{"additionalProperties":false,"properties":{"cost_usd":{"type":"number"},"egress_bytes":{"type":"integer"},"egress_cost_usd":{"type":"number"},"ingress_bytes":{"type":"integer"},"ingress_cost_usd":{"type":"number"},"month_utc":{"pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"},"storage_byte_seconds":{"type":"integer"},"storage_cost_usd":{"type":"number"}},"required":["month_utc","ingress_bytes","egress_bytes","storage_byte_seconds","ingress_cost_usd","egress_cost_usd","storage_cost_usd","cost_usd"],"type":"object"},"LabsObject":{"additionalProperties":true,"type":"object"},"MediaAsset":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"delivery":{"additionalProperties":false,"properties":{"image_url":{"format":"uri","type":"string"},"poster_url":{"format":"uri","type":"string"},"video_manifest_url":{"format":"uri","type":"string"}},"type":"object"},"duration_seconds":{"type":"number"},"error":{"type":"string"},"filename":{"type":"string"},"height":{"type":"integer"},"id":{"type":"string"},"source_size_bytes":{"type":"integer"},"status":{"enum":["created","uploaded","processing","ready","failed","deleted"],"type":"string"},"type":{"enum":["image","video"],"type":"string"},"updated_at":{"format":"date-time","type":"string"},"visibility":{"enum":["public","private"],"type":"string"},"width":{"type":"integer"}},"required":["id","type","visibility","filename","content_type","status","source_size_bytes","created_at","updated_at","delivery"],"type":"object"},"MediaAssetCreateRequest":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"filename":{"type":"string"},"type":{"enum":["image","video"],"type":"string"},"visibility":{"default":"private","enum":["public","private"],"type":"string"}},"required":["type"],"type":"object"},"MediaAssetCreateResponse":{"additionalProperties":false,"properties":{"asset":{"$ref":"#/components/schemas/MediaAsset"},"object":{"const":"media.asset_create","type":"string"},"upload":{"$ref":"#/components/schemas/MediaUpload"}},"required":["object","asset","upload"],"type":"object"},"MediaAssetList":{"additionalProperties":false,"properties":{"assets":{"items":{"$ref":"#/components/schemas/MediaAsset"},"type":"array"},"object":{"const":"media.asset_list","type":"string"}},"required":["object","assets"],"type":"object"},"MediaAssetPatchRequest":{"additionalProperties":false,"properties":{"filename":{"type":"string"},"visibility":{"enum":["public","private"],"type":"string"}},"type":"object"},"MediaBinaryResponse":{"description":"Raw media bytes such as an image, HLS manifest, poster, thumbnail, or segment.","format":"binary","type":"string"},"MediaMultipartCompletePart":{"additionalProperties":false,"properties":{"etag":{"type":"string"},"part_number":{"minimum":1,"type":"integer"},"size_bytes":{"minimum":0,"type":"integer"}},"required":["part_number","etag"],"type":"object"},"MediaMultipartCompleteRequest":{"additionalProperties":false,"properties":{"parts":{"items":{"$ref":"#/components/schemas/MediaMultipartCompletePart"},"type":"array"}},"type":"object"},"MediaMultipartInitiateRequest":{"additionalProperties":false,"properties":{"content_type":{"type":"string"},"part_size_bytes":{"minimum":1048576,"type":"integer"},"total_bytes":{"minimum":1,"type":"integer"}},"type":"object"},"MediaMultipartPart":{"additionalProperties":false,"properties":{"asset_id":{"type":"string"},"etag":{"type":"string"},"object":{"const":"media.multipart_part","type":"string"},"part_number":{"type":"integer"},"size_bytes":{"type":"integer"},"upload_id":{"type":"string"}},"required":["object","upload_id","asset_id","part_number","size_bytes","etag"],"type":"object"},"MediaMultipartPartResult":{"oneOf":[{"$ref":"#/components/schemas/MediaMultipartPart"},{"$ref":"#/components/schemas/MediaMultipartPartUrls"}]},"MediaMultipartPartUrl":{"additionalProperties":false,"properties":{"expires_at":{"format":"date-time","type":"string"},"headers":{"additionalProperties":{"type":"string"},"type":"object"},"method":{"const":"PUT","type":"string"},"part_number":{"minimum":1,"type":"integer"},"url":{"format":"uri","type":"string"}},"required":["part_number","method","url","headers","expires_at"],"type":"object"},"MediaMultipartPartUrls":{"additionalProperties":false,"properties":{"asset_id":{"type":"string"},"direct_provider":{"const":true,"type":"boolean"},"object":{"const":"media.multipart_part_urls","type":"string"},"parts":{"items":{"$ref":"#/components/schemas/MediaMultipartPartUrl"},"type":"array"},"upload_id":{"type":"string"}},"required":["object","upload_id","asset_id","direct_provider","parts"],"type":"object"},"MediaMultipartPartUrlsRequest":{"additionalProperties":false,"properties":{"part_numbers":{"items":{"minimum":1,"type":"integer"},"maxItems":100,"minItems":1,"type":"array"}},"required":["part_numbers"],"type":"object"},"MediaMultipartUpload":{"additionalProperties":false,"properties":{"abort_url":{"format":"uri","type":"string"},"asset_id":{"type":"string"},"complete_url":{"format":"uri","type":"string"},"direct_provider":{"type":"boolean"},"expires_at":{"format":"date-time","type":"string"},"max_bytes":{"type":"integer"},"method":{"type":"string"},"object":{"const":"media.multipart_upload","type":"string"},"part_size_bytes":{"type":"integer"},"parts_url":{"format":"uri","type":"string"},"status":{"enum":["active","aborted","completed"],"type":"string"},"upload_id":{"type":"string"}},"required":["object","upload_id","asset_id","status","method","parts_url","complete_url","abort_url","expires_at","part_size_bytes","max_bytes","direct_provider"],"type":"object"},"MediaSignedUrlRequest":{"additionalProperties":false,"properties":{"delivery":{"enum":["image","image_variant","video_manifest","video_poster","video_thumbnail","video_rendition"],"type":"string"},"expires_in_seconds":{"maximum":604800,"minimum":60,"type":"integer"},"file":{"type":"string"},"rendition":{"type":"string"},"thumb":{"type":"string"},"transform":{"additionalProperties":{"type":"string"},"type":"object"},"variant":{"type":"string"}},"type":"object"},"MediaSignedUrlResponse":{"additionalProperties":false,"properties":{"expires_at":{"format":"date-time","type":"string"},"object":{"const":"media.signed_url","type":"string"},"url":{"format":"uri","type":"string"}},"required":["object","url","expires_at"],"type":"object"},"MediaUpload":{"additionalProperties":false,"properties":{"expires_at":{"format":"date-time","type":"string"},"max_bytes":{"type":"integer"},"method":{"const":"PUT","type":"string"},"url":{"format":"uri","type":"string"}},"required":["method","url","expires_at","max_bytes"],"type":"object"},"MediaUsage":{"additionalProperties":false,"properties":{"active_multipart_uploads":{"type":"integer"},"asset_count":{"type":"integer"},"derivative_bytes":{"type":"integer"},"object":{"const":"media.usage","type":"string"},"queued_jobs":{"type":"integer"},"recent_events":{"items":{"additionalProperties":false,"properties":{"bytes":{"type":"integer"},"created_at":{"format":"date-time","type":"string"},"event_type":{"type":"string"},"quantity":{"type":"number"}},"required":["event_type","quantity","bytes","created_at"],"type":"object"},"type":"array"},"source_bytes":{"type":"integer"}},"required":["object","asset_count","source_bytes","derivative_bytes","queued_jobs","active_multipart_uploads","recent_events"],"type":"object"},"MergeDecision":{"additionalProperties":true,"properties":{"checkpoint_artifact":{"type":"string"},"merged_artifact":{"type":"string"},"reasons":{"items":{"type":"string"},"type":"array"},"rollback_artifact":{"type":"string"},"status":{"type":"string"},"winning_candidate_id":{"type":"string"}},"required":["status"],"type":"object"},"MeterEvent":{"additionalProperties":false,"properties":{"billable_quantity":{"type":"number"},"cost_usd":{"type":"number"},"created_at":{"format":"date-time","type":"string"},"free_quantity":{"type":"number"},"id":{"type":"string"},"meter":{"type":"string"},"quantity":{"type":"number"},"service":{"type":"string"}},"required":["id","service","meter","quantity","free_quantity","billable_quantity","cost_usd","created_at"],"type":"object"},"MeterEventMeterSummary":{"additionalProperties":false,"properties":{"billable_quantity":{"type":"number"},"cost_usd":{"type":"number"},"event_count":{"type":"integer"},"free_quantity":{"type":"number"},"meter":{"type":"string"},"quantity":{"type":"number"},"service":{"type":"string"}},"required":["service","meter","event_count","quantity","free_quantity","billable_quantity","cost_usd"],"type":"object"},"MeterEventSummary":{"additionalProperties":false,"properties":{"meters":{"items":{"$ref":"#/components/schemas/MeterEventMeterSummary"},"type":"array"},"object":{"const":"meter_events.summary","type":"string"},"records":{"items":{"$ref":"#/components/schemas/MeterEvent"},"type":"array"},"total_billable_quantity":{"type":"number"},"total_cost_usd":{"type":"number"},"total_events":{"type":"integer"},"total_free_quantity":{"type":"number"},"total_quantity":{"type":"number"}},"required":["object","total_events","total_quantity","total_free_quantity","total_billable_quantity","total_cost_usd","meters","records"],"type":"object"},"Model":{"additionalProperties":false,"properties":{"availability_label":{"type":"string"},"available":{"type":"boolean"},"catalog_tier":{"enum":["recommended","tier_1","tier_2","catalog"],"type":"string"},"compatibility_flags":{"items":{"type":"string"},"type":"array"},"created":{"type":"integer"},"deprecated_at":{"format":"date-time","type":"string"},"display_name":{"type":"string"},"id":{"type":"string"},"input_token_rate":{"type":"number"},"is_default":{"type":"boolean"},"latency_class":{"enum":["low","standard","deep"],"type":"string"},"max_context_tokens":{"type":"integer"},"max_input_tokens":{"type":"integer"},"max_output_tokens":{"type":"integer"},"object":{"const":"model","type":"string"},"output_token_rate":{"type":"number"},"owned_by":{"type":"string"},"price_cards":{"items":{"$ref":"#/components/schemas/ProviderPriceCard"},"type":"array"},"recommended":{"type":"boolean"},"recommended_for":{"items":{"type":"string"},"type":"array"},"replaces":{"items":{"type":"string"},"type":"array"},"status":{"enum":["available","degraded","temporarily_unavailable","not_enabled","deprecated"],"type":"string"},"sunset_at":{"format":"date-time","type":"string"},"supports_chat":{"type":"boolean"},"supports_code":{"type":"boolean"},"supports_embeddings":{"type":"boolean"},"supports_json_schema":{"type":"boolean"},"supports_parallel_tool_calls":{"type":"boolean"},"supports_reasoning":{"type":"boolean"},"supports_streaming":{"type":"boolean"},"supports_tool_choice":{"type":"boolean"},"supports_tool_json_schema":{"type":"boolean"},"supports_tools":{"type":"boolean"},"supports_vision":{"type":"boolean"}},"required":["id","object","owned_by","display_name","available","status","input_token_rate","output_token_rate"],"type":"object"},"ModelGroup":{"additionalProperties":false,"properties":{"id":{"enum":["recommended","tier_1","tier_2","embeddings"],"type":"string"},"label":{"type":"string"},"model_ids":{"items":{"type":"string"},"type":"array"}},"required":["id","label","model_ids"],"type":"object"},"ModelList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Model"},"type":"array"},"groups":{"items":{"$ref":"#/components/schemas/ModelGroup"},"type":"array"},"object":{"const":"list","type":"string"}},"required":["object","data"],"type":"object"},"ModelRecommendation":{"additionalProperties":false,"properties":{"available":{"type":"boolean"},"display_name":{"type":"string"},"input_token_rate":{"type":"number"},"latency_class":{"type":"string"},"model":{"type":"string"},"output_token_rate":{"type":"number"},"reason":{"type":"string"},"score":{"type":"number"},"status":{"type":"string"}},"required":["model","display_name","reason","score","available","status","input_token_rate","output_token_rate"],"type":"object"},"ModelRecommendationRequest":{"additionalProperties":false,"properties":{"include_unavailable":{"type":"boolean"},"max_cost_per_million_output_usd":{"type":"number"},"max_input_tokens":{"type":"integer"},"prefer_low_latency":{"type":"boolean"},"quality_tier":{"enum":["low_cost","balanced","premium"],"type":"string"},"require_json_schema":{"type":"boolean"},"require_tools":{"type":"boolean"},"require_vision":{"type":"boolean"},"task":{"type":"string"}},"type":"object"},"ModelRecommendationResponse":{"additionalProperties":false,"properties":{"object":{"const":"model.recommendations","type":"string"},"recommendations":{"items":{"$ref":"#/components/schemas/ModelRecommendation"},"type":"array"}},"required":["object","recommendations"],"type":"object"},"NodeRegionAttestationKey":{"additionalProperties":true,"properties":{"kid":{"description":"Stable identifier for the keypair version.","type":"string"},"node_id":{"format":"uuid","type":"string"},"public_key_b64":{"description":"Ed25519 public key, base64-standard encoded (32 raw bytes).","type":"string"},"region":{"nullable":true,"type":"string"},"rotated_at":{"format":"date-time","nullable":true,"type":"string"}},"required":["node_id","kid","public_key_b64"],"type":"object"},"ObjectStorageAllocation":{"additionalProperties":false,"properties":{"allocation_bytes":{"type":"integer"},"billing_user_id":{"type":"string"},"blocked":{"type":"boolean"},"free_bytes":{"type":"integer"},"month_utc":{"pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"},"purchased_tb_blocks":{"type":"integer"},"remaining_bytes":{"type":"integer"},"used_bytes":{"type":"integer"}},"required":["billing_user_id","month_utc","free_bytes","purchased_tb_blocks","allocation_bytes","used_bytes","remaining_bytes","blocked"],"type":"object"},"ObjectStorageAllocationCreateRequest":{"additionalProperties":false,"properties":{"blocks":{"minimum":1,"type":"integer"},"idempotency_key":{"type":"string"},"month_utc":{"pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"}},"required":["blocks"],"type":"object"},"ObjectStorageS3Response":{"description":"S3-compatible XML response or raw object body.","oneOf":[{"type":"string"},{"format":"binary","type":"string"}]},"ObjectStorageSummary":{"additionalProperties":true,"properties":{"allocation":{"$ref":"#/components/schemas/ObjectStorageAllocation"},"buckets":{"items":{"type":"object"},"type":"array"},"endpoint":{"format":"uri","type":"string"},"keys":{"items":{"type":"object"},"type":"array"},"month_utc":{"pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"},"object":{"const":"object_storage.summary","type":"string"},"rate_card":{"type":"object"}},"required":["object","endpoint","month_utc","allocation","rate_card","buckets","keys"],"type":"object"},"OpenApiDocument":{"additionalProperties":true,"description":"The public OpenAPI 3.1 document.","type":"object"},"OrchestrationArtifactsResponse":{"additionalProperties":true,"properties":{"artifacts":{"items":{"additionalProperties":true,"type":"object"},"type":"array"}},"required":["artifacts"],"type":"object"},"OrchestrationCandidatesResponse":{"additionalProperties":true,"properties":{"candidates":{"items":{"additionalProperties":true,"type":"object"},"type":"array"}},"required":["candidates"],"type":"object"},"OrchestrationCreateRequest":{"additionalProperties":true,"properties":{"auto_merge":{"default":true,"type":"boolean"},"max_parallel":{"maximum":8,"minimum":1,"type":"integer"},"model":{"type":"string"},"prompt":{"type":"string"},"repo_ref":{"type":"string"},"workspace":{"format":"uuid","type":"string"}},"required":["prompt","workspace"],"type":"object"},"OrchestrationEventsResponse":{"additionalProperties":true,"properties":{"events":{"items":{"additionalProperties":true,"type":"object"},"type":"array"}},"required":["events"],"type":"object"},"OrchestrationLocksResponse":{"additionalProperties":true,"properties":{"locks":{"items":{"additionalProperties":true,"type":"object"},"type":"array"}},"required":["locks"],"type":"object"},"OrchestrationRun":{"additionalProperties":true,"properties":{"candidates":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"events":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"id":{"type":"string"},"locks":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"merge_decision":{"$ref":"#/components/schemas/MergeDecision"},"object":{"const":"orchestration_run","type":"string"},"policy":{"additionalProperties":true,"type":"object"},"prompt":{"type":"string"},"repo_ref":{"type":"string"},"risk_summary":{"additionalProperties":true,"type":"object"},"role_graph":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"schema_version":{"type":"integer"},"status":{"type":"string"},"surface":{"type":"string"},"tasks":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"workspace_ref":{"type":"string"}},"required":["object","schema_version","id","prompt","status","policy"],"type":"object"},"OrchestrationTasksResponse":{"additionalProperties":true,"properties":{"tasks":{"items":{"additionalProperties":true,"type":"object"},"type":"array"}},"required":["tasks"],"type":"object"},"OrchestrationUndoResponse":{"additionalProperties":true,"properties":{"merge_decision":{"$ref":"#/components/schemas/MergeDecision"},"rollback_artifact":{"type":"string"},"run":{"$ref":"#/components/schemas/OrchestrationRun"}},"required":["run","merge_decision","rollback_artifact"],"type":"object"},"OrchestrationsListResponse":{"additionalProperties":true,"properties":{"next_cursor":{"type":"string"},"orchestrations":{"items":{"$ref":"#/components/schemas/OrchestrationRun"},"type":"array"}},"required":["orchestrations"],"type":"object"},"ProjectSecret":{"additionalProperties":true,"properties":{"created_at":{"format":"date-time","type":"string"},"description":{"type":"string"},"enabled":{"type":"boolean"},"last_used_at":{"format":"date-time","type":"string"},"linked_apps":{"items":{"type":"string"},"type":"array"},"linked_repos":{"items":{"type":"string"},"type":"array"},"masked_value":{"description":"Masked only; raw secret values are never returned.","type":"string"},"name":{"type":"string"},"object":{"const":"project.secret","type":"string"},"project_id":{"type":"string"},"scope":{"type":"string"},"source_type":{"type":"string"},"updated_at":{"format":"date-time","type":"string"}},"required":["object","project_id","name","scope","masked_value","enabled"],"type":"object"},"ProjectSecretUpsertRequest":{"properties":{"description":{"type":"string"},"enabled":{"type":"boolean"},"linked_apps":{"items":{"type":"string"},"type":"array"},"linked_repos":{"items":{"type":"string"},"type":"array"},"scope":{"type":"string"},"value":{"type":"string","writeOnly":true}},"required":["value"],"type":"object"},"ProviderCostBreakdown":{"additionalProperties":false,"properties":{"cached_input_token_rate":{"type":"number"},"cached_input_tokens":{"type":"integer"},"context_band":{"enum":["short","long"],"type":"string"},"cost_usd":{"type":"number"},"effective_date":{"type":"string"},"input_token_rate":{"type":"number"},"output_token_rate":{"type":"number"},"output_tokens":{"type":"integer"},"provider":{"type":"string"},"provider_model_id":{"type":"string"},"public_model_id":{"type":"string"},"reasoning_tokens":{"type":"integer"},"service_tier":{"enum":["standard","priority","batch","flex"],"type":"string"},"uncached_input_tokens":{"type":"integer"}},"required":["provider","public_model_id","provider_model_id","context_band","service_tier","input_token_rate","output_token_rate","uncached_input_tokens","cached_input_tokens","output_tokens","reasoning_tokens","cost_usd"],"type":"object"},"ProviderCredentialCreateRequest":{"additionalProperties":false,"properties":{"api_key":{"format":"password","type":"string"},"base_url":{"description":"Optional HTTPS base URL for OpenAI-compatible provider endpoints.","format":"uri","type":["string","null"]},"label":{"type":"string"},"provider":{"enum":["openai","anthropic","deepseek"],"type":"string"}},"required":["provider","label","api_key"],"type":"object"},"ProviderCredentialList":{"items":{"$ref":"#/components/schemas/ProviderCredentialView"},"type":"array"},"ProviderCredentialPatchRequest":{"additionalProperties":false,"properties":{"api_key":{"format":"password","type":"string"},"base_url":{"description":"Set to null to clear the stored base URL.","format":"uri","type":["string","null"]},"enabled":{"type":"boolean"},"label":{"type":"string"}},"type":"object"},"ProviderCredentialTestResponse":{"additionalProperties":false,"properties":{"credential":{"$ref":"#/components/schemas/ProviderCredentialView"},"message":{"type":"string"},"ok":{"type":"boolean"}},"required":["ok","message","credential"],"type":"object"},"ProviderCredentialView":{"additionalProperties":false,"properties":{"enabled":{"type":"boolean"},"health":{"enum":["disabled","error","healthy","untested"],"type":"string"},"id":{"type":"string"},"label":{"type":"string"},"last_error":{"type":"string"},"last_tested_at":{"type":"integer"},"last_used_at":{"type":"integer"},"masked_key":{"type":"string"},"provider":{"enum":["openai","anthropic","deepseek"],"type":"string"}},"required":["id","provider","label","masked_key","enabled"],"type":"object"},"ProviderPriceCard":{"additionalProperties":false,"properties":{"cached_input_token_rate":{"type":"number"},"context_band":{"enum":["short","long"],"type":"string"},"context_token_threshold":{"type":"integer"},"effective_date":{"type":"string"},"input_token_rate":{"type":"number"},"output_token_rate":{"type":"number"},"provider":{"type":"string"},"provider_model_id":{"type":"string"},"public_model_id":{"type":"string"},"service_tier":{"enum":["standard","priority","batch","flex"],"type":"string"}},"required":["provider","public_model_id","provider_model_id","context_band","service_tier","input_token_rate","output_token_rate"],"type":"object"},"PublicModelStatus":{"additionalProperties":false,"properties":{"available":{"type":"boolean"},"catalog_tier":{"enum":["recommended","tier_1","tier_2","catalog"],"type":"string"},"display_name":{"type":"string"},"id":{"type":"string"},"latency_class":{"type":"string"},"status":{"type":"string"},"supports_chat":{"type":"boolean"},"supports_code":{"type":"boolean"},"supports_embeddings":{"type":"boolean"},"supports_json_schema":{"type":"boolean"},"supports_reasoning":{"type":"boolean"},"supports_tools":{"type":"boolean"},"supports_vision":{"type":"boolean"}},"required":["id","display_name","available","status"],"type":"object"},"PublicReady":{"additionalProperties":false,"properties":{"generated_at_unix":{"type":"integer"},"models":{"items":{"$ref":"#/components/schemas/PublicReadyModel"},"type":"array"},"object":{"const":"ipop.ready","type":"string"},"ready":{"type":"boolean"},"recommended_model_id":{"type":"string"},"setup":{"$ref":"#/components/schemas/PublicReadySetup"}},"required":["object","ready","generated_at_unix","models","setup"],"type":"object"},"PublicReadyModel":{"additionalProperties":false,"properties":{"display_name":{"type":"string"},"id":{"type":"string"},"ready":{"type":"boolean"},"status":{"type":"string"},"supports_chat":{"type":"boolean"},"supports_embeddings":{"type":"boolean"}},"required":["id","display_name","ready","status","supports_chat","supports_embeddings"],"type":"object"},"PublicReadySetup":{"additionalProperties":false,"properties":{"chat_check":{"type":"string"},"env":{"type":"string"},"health_check":{"type":"string"}},"required":["env","health_check","chat_check"],"type":"object"},"PublicRequestMetadata":{"additionalProperties":true,"properties":{"adaptive_speculative_decoding":{"type":"boolean"},"apply_model_diff_repair_requests":{"type":"integer"},"apply_model_diff_requests":{"type":"integer"},"apply_model_fallback_rewrites":{"type":"integer"},"apply_model_latency_ms_total":{"type":"integer"},"apply_model_requests":{"type":"integer"},"apply_model_successes":{"type":"integer"},"approximate_tokens_ok":{"type":"boolean"},"byok_fallback_policy":{"enum":["byok_first_with_hosted_fallback","byok_only","hosted_only","fail_closed_on_byok_error"],"type":"string"},"cache_mode":{"enum":["default","aggressive","bypass"],"type":"string"},"client_disconnect_cancel":{"type":"boolean"},"contains_pii":{"type":"boolean"},"context_cleaner_bytes_saved":{"type":"integer"},"context_delta_base_key":{"type":"string"},"context_delta_bytes":{"type":"integer"},"context_delta_message_count":{"type":"integer"},"context_delta_message_offset":{"type":"integer"},"context_delta_policy":{"enum":["none","metadata"],"type":"string"},"context_latency_budget_policy":{"enum":["default","aggressive"],"type":"string"},"disable_external_fallback":{"description":"Test/admin-only. Honored only for authenticated smoke/load-test contexts.","type":"boolean"},"dispatch_push_policy":{"enum":["claim_long_poll_notify","persistent_stream"],"type":"string"},"early_answer_policy":{"enum":["none","stream_first_sentence"],"type":"string"},"fallback_profile":{"enum":["network_first","latency_first","cost_first","privacy_first"],"type":"string"},"fast_lane":{"type":"boolean"},"hard_session_pin":{"type":"boolean"},"hedge_after_ms":{"type":"integer"},"hot_slot_count":{"type":"integer"},"include_route_metadata":{"type":"boolean"},"intent_tool_prefetch":{"type":"boolean"},"kv_cache_policy":{"enum":["none","prefix_reuse"],"type":"string"},"latency_admission_policy":{"enum":["default","interactive_slo"],"type":"string"},"latency_canary_policy":{"enum":["none","probe"],"type":"string"},"latency_policy_variant":{"enum":["a","b"],"type":"string"},"latency_profile":{"type":"string"},"latency_queue_budget_ms":{"type":"integer"},"latency_target_ms":{"type":"integer"},"latency_tier":{"enum":["fast","balanced","deep"],"type":"string"},"max_cost_usd":{"type":"number"},"max_output_tokens":{"type":"integer"},"microbatch_window_ms":{"type":"integer"},"no_tool_fast_path":{"type":"boolean"},"partial_result_policy":{"enum":["none","progress_events"],"type":"string"},"prefer_region":{"type":"string"},"prefill_queue_policy":{"enum":["inline","dedicated"],"type":"string"},"prefill_warm":{"type":"boolean"},"prefix_cache_canonicalization":{"enum":["none","terminail_v2"],"type":"string"},"prefix_cache_key":{"type":"string"},"priority":{"enum":["background","foreground","interactive","realtime"],"type":"string"},"prompt_budget_bytes":{"type":"integer"},"prompt_bytes":{"type":"integer"},"prompt_cache_key":{"type":"string"},"prompt_cache_policy":{"default":"auto","enum":["auto","off"],"type":"string"},"prompt_cache_ttl":{"default":"5m","enum":["5m","1h"],"type":"string"},"quality_tier":{"enum":["low_cost","balanced","premium"],"type":"string"},"read_file_cache_hits":{"type":"integer"},"read_file_cache_misses":{"type":"integer"},"read_file_unchanged_markers":{"type":"integer"},"reasoning_effort":{"enum":["low","medium","high","xhigh"],"type":"string"},"request_type":{"type":"string"},"resident_hot_load":{"type":"boolean"},"semantic_index_chunk_count":{"type":"integer"},"semantic_index_fallback_embedding_chunks":{"type":"integer"},"semantic_index_indexed_file_count":{"type":"integer"},"semantic_index_last_refresh_unix_secs":{"type":"integer"},"semantic_index_stale_file_count":{"type":"integer"},"semantic_retrieval_chunk_ids":{"items":{"type":"string"},"type":"array"},"semantic_retrieval_context_bytes":{"type":"integer"},"sensitive":{"type":"boolean"},"service_tier":{"enum":["standard","priority"],"type":"string"},"session_id":{"type":"string"},"small_model_first":{"type":"boolean"},"speculative_prepare_execution":{"type":"boolean"},"stream_backpressure_policy":{"enum":["none","dispatch_backoff"],"type":"string"},"tool_result_cache_policy":{"enum":["none","turn","cross_turn"],"type":"string"},"tool_result_cache_ttl_ms":{"type":"integer"},"tool_schema_hash":{"type":"string"},"tool_schema_policy":{"enum":["inline","hash_reference"],"type":"string"},"transport_streaming_profile":{"enum":["default","flush"],"type":"string"},"ttft_target_ms":{"type":"integer"}},"type":"object"},"PublicStatus":{"additionalProperties":false,"properties":{"generated_at_unix":{"type":"integer"},"models":{"items":{"$ref":"#/components/schemas/PublicModelStatus"},"type":"array"},"object":{"const":"ipop.status","type":"string"},"status":{"enum":["available","degraded","not_enabled"],"type":"string"}},"required":["object","status","generated_at_unix","models"],"type":"object"},"RegionAttestationEnvelope":{"additionalProperties":true,"properties":{"completed_at":{"format":"date-time","type":"string"},"node_id":{"format":"uuid","type":"string"},"prompt_hash":{"description":"SHA-256 of the prompt input bytes, hex-encoded.","type":"string"},"region":{"type":"string"},"request_id":{"format":"uuid","type":"string"},"signature_b64":{"description":"Ed25519 signature over canonical bytes (envelope with `signature_b64` set to empty string), base64-standard encoded (64 raw bytes).","type":"string"},"signer_kid":{"description":"Look up the matching public key in /v1/regions/keys.","type":"string"}},"required":["region","node_id","request_id","prompt_hash","completed_at","signer_kid","signature_b64"],"type":"object"},"RegionAttestationKeysResponse":{"additionalProperties":true,"properties":{"data":{"items":{"$ref":"#/components/schemas/NodeRegionAttestationKey"},"type":"array"},"object":{"const":"list","type":"string"}},"required":["object","data"],"type":"object"},"RegionCatalogEntry":{"additionalProperties":true,"properties":{"available_models":{"description":"Per-region union of model ids the nodes advertise. Empty when caller is unauthenticated.","items":{"type":"string"},"type":"array"},"capacity_bucket":{"description":"Coarse capacity indicator. Never leaks exact node counts.","enum":["none","low","medium","high"],"type":"string"},"region":{"type":"string"}},"required":["region","capacity_bucket"],"type":"object"},"RegionCatalogResponse":{"additionalProperties":true,"properties":{"data":{"items":{"$ref":"#/components/schemas/RegionCatalogEntry"},"type":"array"},"object":{"const":"list","type":"string"}},"required":["object","data"],"type":"object"},"RequestFeedbackRequest":{"additionalProperties":false,"properties":{"notes":{"type":"string"},"outcome":{"type":"string"},"rating":{"maximum":1,"minimum":-1,"type":"integer"},"task_type":{"type":"string"}},"type":"object"},"RequestFeedbackResponse":{"additionalProperties":false,"properties":{"object":{"const":"request.feedback","type":"string"},"recorded":{"type":"boolean"},"request_id":{"type":"string"}},"required":["object","request_id","recorded"],"type":"object"},"RequestHistoryList":{"items":{"$ref":"#/components/schemas/RequestHistoryRecord"},"type":"array"},"RequestHistoryRecord":{"additionalProperties":false,"properties":{"cancellation_reason":{"type":"string"},"completed_at":{"format":"date-time","type":"string"},"cost":{"type":"number"},"created_at":{"format":"date-time","type":"string"},"error":{"type":"string"},"execution_kind":{"type":"string"},"model":{"type":"string"},"request_id":{"type":"string"},"request_metadata":{"type":"object"},"requested_model_id":{"type":"string"},"result_preview":{"type":"string"},"started_at":{"format":"date-time","type":"string"},"status":{"type":"string"},"token_details":{"$ref":"#/components/schemas/InferenceTokenUsageDetails"},"tokens_in":{"type":"integer"},"tokens_out":{"type":"integer"},"updated_at":{"format":"date-time","type":"string"}},"required":["request_id","model","execution_kind","status","tokens_in","tokens_out","cost","created_at","updated_at"],"type":"object"},"ResponseContentPart":{"additionalProperties":true,"properties":{"detail":{"enum":["auto","low","high"],"type":"string"},"file_data":{"type":"string"},"file_id":{"type":"string"},"file_url":{"type":"string"},"filename":{"type":"string"},"image_url":{"type":"string"},"text":{"type":"string"},"type":{"enum":["input_text","output_text","text","input_image","image_url","input_file","file"],"type":"string"}},"required":["type"],"type":"object"},"ResponseDeleted":{"additionalProperties":false,"properties":{"deleted":{"type":"boolean"},"id":{"type":"string"},"object":{"const":"response","type":"string"}},"required":["id","object","deleted"],"type":"object"},"ResponseIncludeValue":{"enum":["file_search_call.results","message.input_image.image_url","computer_call_output.output.image_url","reasoning.encrypted_content"],"type":"string"},"ResponseInput":{"oneOf":[{"type":"string"},{"items":{"$ref":"#/components/schemas/ResponseInputItem"},"type":"array"}]},"ResponseInputItem":{"additionalProperties":true,"properties":{"content":{"oneOf":[{"type":"string"},{"items":{"$ref":"#/components/schemas/ResponseContentPart"},"type":"array"}]},"id":{"type":"string"},"role":{"enum":["system","developer","user","assistant","tool"],"type":"string"},"type":{"enum":["message","input_message","function_call_output"],"type":"string"}},"type":"object"},"ResponseInputItemList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/ResponseItem"},"type":"array"},"first_id":{"type":"string"},"has_more":{"type":"boolean"},"last_id":{"type":"string"},"object":{"const":"list","type":"string"}},"required":["object","data","has_more"],"type":"object"},"ResponseInputTokensRequest":{"additionalProperties":false,"properties":{"conversation":{},"include":{"items":{"$ref":"#/components/schemas/ResponseIncludeValue"},"type":"array"},"input":{"$ref":"#/components/schemas/ResponseInput"},"instructions":{"$ref":"#/components/schemas/ResponseInstructions"},"model":{"description":"Use one of the launch public model IDs.","enum":["ipop/coder-balanced","claude-sonnet-4.6","grok-build-0.1","step-3.7-flash","claude-opus-4.8-fast","claude-opus-4.8","openai/gpt-5.5","openai/gpt-5.4","grok-4.3","gemini-3.5-flash","qwen3.7-max","openai/gpt-5.4-mini","deepseek-v4-pro","qwen3-235b-a22b-thinking-2507","openai/gpt-5-nano","gemini-3.1-flash-lite","kimi-k2.6","deepseek-v4-flash","mistral-small-2603","codestral-2508","ling-2.6-flash"],"examples":["ipop/coder-balanced","grok-build-0.1","deepseek-v4-flash"],"type":"string"},"previous_response_id":{"type":"string"},"truncation":{"oneOf":[{"enum":["auto","disabled"],"type":"string"},{"additionalProperties":true,"type":"object"}]}},"type":"object"},"ResponseInputTokensResponse":{"additionalProperties":false,"properties":{"input_tokens":{"type":"integer"},"input_tokens_details":{"additionalProperties":true,"properties":{"cache_creation_input_tokens":{"type":"integer"},"cached_tokens":{"type":"integer"}},"type":"object"},"object":{"const":"response.input_tokens","type":"string"}},"required":["object","input_tokens","input_tokens_details"],"type":"object"},"ResponseInstructions":{"oneOf":[{"type":"string"},{"items":{"additionalProperties":true,"type":"object"},"type":"array"}]},"ResponseItem":{"additionalProperties":false,"properties":{"arguments":{"type":"string"},"call_id":{"type":"string"},"content":{"items":{"$ref":"#/components/schemas/ResponseContentPart"},"type":"array"},"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"status":{"type":"string"},"type":{"enum":["message","function_call","function_call_output"],"type":"string"}},"required":["id","type"],"type":"object"},"ResponseObject":{"additionalProperties":false,"properties":{"background":{"type":"boolean"},"created_at":{"type":"integer"},"error":{"additionalProperties":true,"type":"object"},"id":{"type":"string"},"incomplete_details":{"additionalProperties":true,"type":"object"},"instructions":{},"metadata":{"additionalProperties":true,"type":"object"},"model":{"type":"string"},"object":{"const":"response","type":"string"},"output":{"items":{"$ref":"#/components/schemas/ResponseItem"},"type":"array"},"output_text":{"type":"string"},"previous_response_id":{"type":"string"},"service_tier":{"type":"string"},"status":{"enum":["queued","in_progress","completed","cancelled","failed","incomplete"],"type":"string"},"store":{"type":"boolean"},"usage":{"$ref":"#/components/schemas/ResponseUsage"}},"required":["id","object","created_at","status","model","output","output_text","usage"],"type":"object"},"ResponseTool":{"additionalProperties":true,"properties":{"description":{"type":"string"},"max_num_results":{"maximum":50,"minimum":1,"type":"integer"},"name":{"type":"string"},"parameters":{"additionalProperties":true,"type":"object"},"strict":{"type":"boolean"},"type":{"enum":["function","file_search","web_search_preview","computer_use_preview","code_interpreter","image_generation","mcp"],"type":"string"},"vector_store_ids":{"items":{"type":"string"},"type":"array"}},"required":["type"],"type":"object"},"ResponseUsage":{"additionalProperties":false,"properties":{"input_tokens":{"type":"integer"},"input_tokens_details":{"additionalProperties":true,"properties":{"cache_creation_input_tokens":{"type":"integer"},"cached_tokens":{"type":"integer"}},"type":"object"},"output_tokens":{"type":"integer"},"output_tokens_details":{"additionalProperties":true,"properties":{"reasoning_tokens":{"type":"integer"}},"type":"object"},"total_tokens":{"type":"integer"}},"required":["input_tokens","output_tokens","total_tokens"],"type":"object"},"ResponsesCreateRequest":{"additionalProperties":false,"properties":{"background":{"default":false,"type":"boolean"},"conversation":{},"include":{"items":{"$ref":"#/components/schemas/ResponseIncludeValue"},"type":"array"},"input":{"$ref":"#/components/schemas/ResponseInput"},"instructions":{"$ref":"#/components/schemas/ResponseInstructions"},"max_output_tokens":{"minimum":1,"type":"integer"},"metadata":{"additionalProperties":true,"type":"object"},"model":{"description":"Use one of the launch public model IDs.","enum":["ipop/coder-balanced","claude-sonnet-4.6","grok-build-0.1","step-3.7-flash","claude-opus-4.8-fast","claude-opus-4.8","openai/gpt-5.5","openai/gpt-5.4","grok-4.3","gemini-3.5-flash","qwen3.7-max","openai/gpt-5.4-mini","deepseek-v4-pro","qwen3-235b-a22b-thinking-2507","openai/gpt-5-nano","gemini-3.1-flash-lite","kimi-k2.6","deepseek-v4-flash","mistral-small-2603","codestral-2508","ling-2.6-flash"],"examples":["ipop/coder-balanced","grok-build-0.1","deepseek-v4-flash"],"type":"string"},"parallel_tool_calls":{"type":"boolean"},"previous_response_id":{"type":"string"},"reasoning":{"additionalProperties":true,"type":"object"},"service_tier":{"enum":["standard","priority","batch","flex"],"type":"string"},"store":{"default":true,"type":"boolean"},"stream":{"default":false,"type":"boolean"},"stream_options":{"additionalProperties":true,"properties":{"include_usage":{"type":"boolean"}},"type":"object"},"temperature":{"type":"number"},"text":{"additionalProperties":true,"type":"object"},"tool_choice":{},"tools":{"items":{"$ref":"#/components/schemas/ResponseTool"},"type":"array"},"top_p":{"type":"number"},"truncation":{"oneOf":[{"enum":["auto","disabled"],"type":"string"},{"additionalProperties":true,"type":"object"}]}},"required":["model"],"type":"object"},"SolanaJsonRpcRequest":{"oneOf":[{"additionalProperties":true,"properties":{"id":{},"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{}},"required":["method"],"type":"object"},{"items":{"additionalProperties":true,"properties":{"id":{},"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{}},"required":["method"],"type":"object"},"minItems":1,"type":"array"}]},"SolanaJsonRpcResponse":{"oneOf":[{"additionalProperties":true,"type":"object"},{"items":{"additionalProperties":true,"type":"object"},"type":"array"}]},"SolanaRpcCatalog":{"additionalProperties":false,"properties":{"currency":{"const":"usd","type":"string"},"generated_at_unix":{"type":"integer"},"launch_positioning":{"type":"string"},"object":{"const":"solana_rpc.catalog","type":"string"},"plans":{"items":{"$ref":"#/components/schemas/SolanaRpcPlan"},"type":"array"},"recommended_plan_id":{"type":"string"}},"required":["object","generated_at_unix","currency","recommended_plan_id","launch_positioning","plans"],"type":"object"},"SolanaRpcMethod":{"additionalProperties":false,"properties":{"cache_policy":{"enum":["prewarmed","lazy_cached","negative_cached","bypass"],"type":"string"},"cache_ttl_ms":{"type":["integer","null"]},"category":{"enum":["accounts","tokens","transactions","blocks","cluster","economics"],"type":"string"},"method":{"type":"string"},"notes":{"type":"string"},"status":{"enum":["tested_available","pass_through","known_upstream_unsupported"],"type":"string"},"tested":{"type":"boolean"}},"required":["method","category","status","tested","notes","cache_policy","cache_ttl_ms"],"type":"object"},"SolanaRpcMethodCatalog":{"additionalProperties":false,"properties":{"generated_at_unix":{"type":"integer"},"methods":{"items":{"$ref":"#/components/schemas/SolanaRpcMethod"},"type":"array"},"notes":{"items":{"type":"string"},"type":"array"},"object":{"const":"solana_rpc.methods","type":"string"},"official_reference_url":{"format":"uri","type":"string"},"transport":{"const":"http_json_rpc","type":"string"},"websocket_supported":{"type":"boolean"}},"required":["object","generated_at_unix","transport","websocket_supported","official_reference_url","notes","methods"],"type":"object"},"SolanaRpcPlan":{"additionalProperties":false,"properties":{"badge":{"type":"string"},"extra_credit_requests_million":{"type":["integer","null"]},"extra_credit_usd":{"type":["number","null"]},"features":{"items":{"type":"string"},"type":"array"},"id":{"type":"string"},"included_requests_million":{"type":["integer","null"]},"monthly_usd":{"type":["number","null"]},"name":{"type":"string"},"summary":{"type":"string"},"websocket":{"type":"boolean"}},"required":["id","name","badge","monthly_usd","included_requests_million","extra_credit_requests_million","extra_credit_usd","websocket","summary","features"],"type":"object"},"UpdateVectorStoreRequest":{"additionalProperties":true,"properties":{"expires_at":{"description":"Double-Option semantics: omit to leave unchanged, `null` to clear, value to set.","format":"date-time","nullable":true,"type":"string"},"metadata":{"additionalProperties":true,"type":"object"},"name":{"maxLength":128,"type":"string"}},"type":"object"},"Usage":{"additionalProperties":false,"properties":{"completion_tokens":{"type":"integer"},"completion_tokens_details":{"additionalProperties":true,"properties":{"reasoning_tokens":{"type":"integer"}},"type":"object"},"prompt_tokens":{"type":"integer"},"prompt_tokens_details":{"additionalProperties":true,"properties":{"cache_creation_input_tokens":{"type":"integer"},"cached_tokens":{"type":"integer"}},"type":"object"},"total_tokens":{"type":"integer"}},"required":["prompt_tokens","completion_tokens","total_tokens"],"type":"object"},"UsageRecord":{"additionalProperties":false,"properties":{"cost":{"type":"number"},"created_at":{"format":"date-time","type":"string"},"duration_ms":{"type":"integer"},"model":{"type":"string"},"provider_billed":{"type":"boolean"},"request_id":{"type":"string"},"token_details":{"$ref":"#/components/schemas/InferenceTokenUsageDetails"},"tokens_in":{"type":"integer"},"tokens_out":{"type":"integer"}},"required":["request_id","model","tokens_in","tokens_out","cost","provider_billed","duration_ms","created_at"],"type":"object"},"UsageSummary":{"additionalProperties":false,"properties":{"records":{"items":{"$ref":"#/components/schemas/UsageRecord"},"type":"array"},"total_cost":{"type":"number"},"total_requests":{"type":"integer"},"total_tokens_in":{"type":"integer"},"total_tokens_out":{"type":"integer"}},"required":["total_requests","total_tokens_in","total_tokens_out","total_cost","records"],"type":"object"},"VectorStore":{"additionalProperties":true,"properties":{"created_at":{"format":"date-time","type":"string"},"deleted_at":{"format":"date-time","nullable":true,"type":"string"},"embedding_model":{"description":"Catalog id of the embedding model. Default `terminaili/embed-balanced`.","type":"string"},"expires_at":{"format":"date-time","nullable":true,"type":"string"},"file_count":{"format":"int64","type":"integer"},"id":{"description":"Stable id, e.g. `vs_abc...`","type":"string"},"metadata":{"additionalProperties":true,"nullable":true,"type":"object"},"name":{"maxLength":128,"type":"string"},"owner_user_id":{"type":"string"},"project_id":{"nullable":true,"type":"string"},"status":{"description":"Rolls to `completed` when every attachment reaches a terminal state. `expired` is set by the auto-expiry sweeper when `expires_at` passes.","enum":["in_progress","completed","expired"],"type":"string"},"updated_at":{"format":"date-time","type":"string"},"usage_bytes":{"format":"int64","type":"integer"}},"required":["id","owner_user_id","name","status","embedding_model","file_count","usage_bytes","created_at","updated_at"],"type":"object"},"VectorStoreFile":{"additionalProperties":true,"properties":{"attached_at":{"format":"date-time","type":"string"},"bytes":{"format":"int64","type":"integer"},"chunk_count":{"format":"int64","type":"integer"},"file_id":{"type":"string"},"id":{"description":"Attachment-row id, e.g. `vsf_abc...`","type":"string"},"indexed_at":{"format":"date-time","nullable":true,"type":"string"},"last_error":{"nullable":true,"type":"string"},"status":{"enum":["in_progress","completed","failed","cancelled"],"type":"string"},"vector_store_id":{"type":"string"}},"required":["id","vector_store_id","file_id","status","chunk_count","bytes","attached_at"],"type":"object"},"VectorStoreFileListResponse":{"additionalProperties":true,"properties":{"data":{"items":{"$ref":"#/components/schemas/VectorStoreFile"},"type":"array"},"object":{"const":"list","type":"string"}},"required":["object","data"],"type":"object"},"VectorStoreListResponse":{"additionalProperties":true,"properties":{"data":{"items":{"$ref":"#/components/schemas/VectorStore"},"type":"array"},"object":{"const":"list","type":"string"}},"required":["object","data"],"type":"object"},"VectorStoreSearchRequest":{"additionalProperties":true,"properties":{"max_num_results":{"default":10,"maximum":50,"minimum":1,"type":"integer"},"query":{"minLength":1,"type":"string"}},"required":["query"],"type":"object"},"VectorStoreSearchResponse":{"additionalProperties":true,"properties":{"data":{"items":{"$ref":"#/components/schemas/VectorStoreSearchResult"},"type":"array"},"has_more":{"type":"boolean"},"object":{"const":"vector_store.search_results.page","type":"string"},"search_query":{"type":"string"}},"required":["object","search_query","data","has_more"],"type":"object"},"VectorStoreSearchResult":{"additionalProperties":true,"properties":{"chunk_id":{"type":"string"},"content":{"items":{"additionalProperties":true,"properties":{"text":{"type":"string"},"type":{"const":"text","type":"string"}},"required":["type","text"],"type":"object"},"type":"array"},"file_id":{"type":"string"},"filename":{"nullable":true,"type":"string"},"score":{"format":"double","type":"number"}},"required":["file_id","score","content","chunk_id"],"type":"object"},"VideoGenerationJob":{"additionalProperties":true,"properties":{"error":{"type":"string"},"generation_id":{"type":"string"},"id":{"type":"string"},"model":{"type":"string"},"object":{"const":"video.generation","type":"string"},"polling_url":{"type":"string"},"status":{"enum":["pending","in_progress","completed","failed","cancelled","expired"],"type":"string"},"unsigned_urls":{"items":{"type":"string"},"type":"array"},"usage":{"additionalProperties":true,"type":"object"}},"required":["id","object","status","model","polling_url"],"type":"object"},"VideoGenerationRequest":{"additionalProperties":true,"properties":{"aspect_ratio":{"type":"string"},"duration":{"maximum":15,"minimum":1,"type":"integer"},"frame_images":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"generate_audio":{"type":"boolean"},"input_references":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"model":{"default":"grok-imagine-video","enum":["grok-imagine-video","x-ai/grok-imagine-video"],"type":"string"},"prompt":{"type":"string"},"resolution":{"enum":["480p","720p"],"type":"string"},"seed":{"type":"integer"},"size":{"description":"Exact WIDTHxHEIGHT output size when supported by the model.","type":"string"}},"required":["prompt"],"type":"object"},"VscodeTrialRequest":{"additionalProperties":false,"properties":{"attribution":{"additionalProperties":true,"type":"object"},"extension_version":{"maxLength":256,"minLength":1,"type":"string"},"installation_id_hash":{"maxLength":256,"minLength":1,"type":"string"},"machine_id_hash":{"maxLength":256,"minLength":1,"type":"string"}},"required":["extension_version","installation_id_hash","machine_id_hash"],"type":"object"},"VscodeTrialResponse":{"additionalProperties":false,"properties":{"allowed_models":{"items":{"enum":["ipop/coder-balanced"],"type":"string"},"type":"array"},"api_key":{"format":"password","type":"string"},"daily_request_limit":{"minimum":1,"type":"integer"},"expires_at":{"format":"date-time","type":"string"},"key_id":{"type":"string"},"object":{"const":"vscode_trial","type":"string"},"project_name":{"type":"string"},"trial_id":{"type":"string"},"upgrade_url":{"format":"uri","type":"string"}},"required":["object","trial_id","api_key","project_name","key_id","allowed_models","daily_request_limit","expires_at","upgrade_url"],"type":"object"}},"securitySchemes":{"AdminToken":{"in":"header","name":"x-admin-token","type":"apiKey"},"ApiKey":{"in":"header","name":"x-api-key","type":"apiKey"},"AwsSigV4":{"in":"header","name":"Authorization","type":"apiKey"},"BearerApiKey":{"scheme":"bearer","type":"http"}}},"info":{"description":"One Terminaili API key, OpenAI-compatible requests, and launch public model IDs.","title":"IPOP Public API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/account/meter-events":{"get":{"parameters":[{"description":"Filter by unified API-credit service name.","in":"query","name":"service","required":false,"schema":{"type":"string"}},{"description":"Filter by meter name within a service.","in":"query","name":"meter","required":false,"schema":{"type":"string"}},{"in":"query","name":"search","required":false,"schema":{"type":"string"}},{"in":"query","name":"created_at_from","required":false,"schema":{"format":"date-time","type":"string"}},{"in":"query","name":"created_at_to","required":false,"schema":{"format":"date-time","type":"string"}},{"in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":500,"maximum":500,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeterEventSummary"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"List unified API credit meter events"}},"/account/meter-events/export":{"get":{"parameters":[{"description":"Filter by unified API-credit service name.","in":"query","name":"service","required":false,"schema":{"type":"string"}},{"description":"Filter by meter name within a service.","in":"query","name":"meter","required":false,"schema":{"type":"string"}},{"in":"query","name":"search","required":false,"schema":{"type":"string"}},{"in":"query","name":"created_at_from","required":false,"schema":{"format":"date-time","type":"string"}},{"in":"query","name":"created_at_to","required":false,"schema":{"format":"date-time","type":"string"}},{"in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":500,"maximum":500,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeterEventSummary"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Export unified API credit meter events"}},"/account/provider-credentials":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCredentialList"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"List account provider credentials"},"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCredentialCreateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCredentialView"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Create an account provider credential"}},"/account/provider-credentials/{credential_id}":{"delete":{"parameters":[{"in":"path","name":"credential_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCredentialView"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Delete an account provider credential"},"patch":{"parameters":[{"in":"path","name":"credential_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCredentialPatchRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCredentialView"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Update an account provider credential"}},"/account/provider-credentials/{credential_id}/test":{"post":{"parameters":[{"in":"path","name":"credential_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCredentialTestResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Test an account provider credential"}},"/admin/box/health":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoxAdminHealth"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AdminToken":[]}],"summary":"Read Project Box operational health"}},"/admin/box/readiness":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoxAdminReadiness"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AdminToken":[]}],"summary":"Read Project Box production readiness"}},"/admin/coding-optimization":{"get":{"parameters":[{"description":"Look-back window in seconds (60-604800, default 900).","in":"query","name":"window_seconds","required":false,"schema":{"default":900,"maximum":604800,"minimum":60,"type":"integer"}},{"description":"Trend bucket size in seconds.","in":"query","name":"bucket_seconds","required":false,"schema":{"default":60,"maximum":86400,"minimum":60,"type":"integer"}},{"in":"query","name":"provider","required":false,"schema":{"type":"string"}},{"in":"query","name":"endpoint","required":false,"schema":{"type":"string"}},{"in":"query","name":"model","required":false,"schema":{"type":"string"}},{"in":"query","name":"repo_id_hash","required":false,"schema":{"type":"string"}},{"in":"query","name":"session_id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CodingOptimizationSummary"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AdminToken":[]}],"summary":"Aggregate coding-session optimization counters without prompt or file content"}},"/admin/inference/events":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceEventQuery"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceEventListResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AdminToken":[]}],"summary":"List structured inference observability events with optional filters and pagination"}},"/admin/inference/export":{"get":{"parameters":[{"in":"query","name":"project_id","required":false,"schema":{"type":"string"}},{"in":"query","name":"model","required":false,"schema":{"type":"string"}},{"in":"query","name":"occurred_at_from","required":false,"schema":{"format":"date-time","type":"string"}},{"in":"query","name":"occurred_at_to","required":false,"schema":{"format":"date-time","type":"string"}},{"in":"query","name":"include_events","required":false,"schema":{"default":true,"type":"boolean"}},{"in":"query","name":"include_messages","required":false,"schema":{"default":true,"type":"boolean"}}],"responses":{"200":{"content":{"application/x-ndjson":{"schema":{"type":"string"}}},"description":"NDJSON stream with one inference_event or inference_message per line."}},"security":[{"AdminToken":[]}],"summary":"Stream inference events and captured messages as application/x-ndjson"}},"/admin/inference/policy":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceContentPolicySummary"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AdminToken":[]}],"summary":"Read the global default and per-project content capture policies"}},"/admin/inference/policy/{project_id}":{"put":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"policy":{"$ref":"#/components/schemas/ContentCapturePolicy"}},"required":["policy"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentCapturePolicy"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AdminToken":[]}],"summary":"Set a project's content capture policy as platform admin"}},"/admin/inference/search":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceSearchQuery"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceSearchResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AdminToken":[]}],"summary":"Full-text search over captured prompts and completions"}},"/admin/inference/stats":{"get":{"parameters":[{"description":"Look-back window in hours (1-168, default 24).","in":"query","name":"window_hours","required":false,"schema":{"default":24,"maximum":168,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceStatsResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AdminToken":[]}],"summary":"Aggregate inference observability counters and top error classes"}},"/admin/inference/streams":{"get":{"description":"Active-only operational view for chat completions and Responses API streams. The stream registry contains request, model, provider, node, and counter metadata, but no prompt, completion, or SSE payload content.","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceStreamsResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AdminToken":[]}],"summary":"List currently open client-facing inference SSE streams"}},"/admin/inference/{request_id}/feedback":{"get":{"parameters":[{"in":"path","name":"request_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceFeedbackListResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AdminToken":[]}],"summary":"Read end-user feedback rows for a request"}},"/admin/inference/{request_id}/messages":{"get":{"parameters":[{"in":"path","name":"request_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceMessagesResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AdminToken":[]}],"summary":"Read captured prompt and completion messages for a request"}},"/admin/inference/{request_id}/timeline":{"get":{"parameters":[{"in":"path","name":"request_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceTimelineResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AdminToken":[]}],"summary":"Read the chronological inference event timeline for a request"}},"/agent-capabilities":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCapabilitiesResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Discover agent-client capabilities"}},"/agent-tool-batches/plan":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentToolBatchPlanRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentToolBatchPlanResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Plan local tool-call execution batches"}},"/agent-turns":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTurnCreateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTurnResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Create a resumable agent-native coding turn"}},"/agent-turns/{request_id}":{"get":{"parameters":[{"in":"path","name":"request_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTurnResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Read a resumable agent turn"}},"/agent-turns/{request_id}/cancel":{"post":{"parameters":[{"in":"path","name":"request_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTurnResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Cancel a running agent turn"}},"/agent-turns/{request_id}/events":{"get":{"parameters":[{"in":"path","name":"request_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"after_event_seq","required":false,"schema":{"minimum":0,"type":"integer"}},{"in":"header","name":"Last-Event-ID","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/event-stream":{"schema":{"type":"string"}}},"description":"Server-Sent Events stream"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Agent turn unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Resume agent turn events"}},"/app-telemetry/envelopes":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppTelemetryEnvelope"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppTelemetryIngestResult"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Ingest App Telemetry events, errors, logs, sessions, page views, and spans"}},"/app-telemetry/plans":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppTelemetryCatalog"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"List App Telemetry pricing and unit weights"}},"/app-telemetry/source-maps":{"put":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppTelemetrySourceMapUpload"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppTelemetrySourceMap"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Upload an App Telemetry source map"}},"/app-telemetry/usage":{"get":{"parameters":[{"in":"query","name":"month","required":false,"schema":{"pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppTelemetryUsage"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Read current project App Telemetry unit usage"}},"/audio/speech":{"post":{"description":"OpenAI-compatible text-to-speech endpoint. Accepts a JSON body with `model`, `voice` (alloy|echo|fable|onyx|nova|shimmer), `input` (≤ 4096 chars), optional `response_format` (mp3|opus|aac|flac|wav|pcm) and `speed` (0.25–4.0). Response is the raw audio bytes with `Content-Type` matching the chosen format. Returns `503 audio_backend_unavailable` with `Retry-After: 60` when no node advertises TTS capability.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAudioSpeechRequest"}}},"required":true},"responses":{"200":{"content":{"audio/mpeg":{"schema":{"format":"binary","type":"string"}},"audio/ogg":{"schema":{"format":"binary","type":"string"}},"audio/wav":{"schema":{"format":"binary","type":"string"}}},"description":"Synthesized audio."},"400":{"description":"Validation error."},"401":{"description":"Authentication required."},"503":{"description":"No node in the fleet advertises audio speech capability. Retry per Retry-After header."}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Synthesize speech audio from text"}},"/audio/transcriptions":{"post":{"description":"OpenAI-compatible speech-to-text endpoint. Accepts a multipart body with a `file` field (≤ 25 MB inline) plus text fields `model`, `response_format` (json|text|srt|verbose_json|vtt), `language` (ISO 639-1), `prompt`, `temperature`. The local `terminaili/whisper` model uses node audio capacity; `parakeet-tdt-0.6b-v3` routes to OpenRouter STT and requires external-provider processing. Returns the configured response shape on success. Returns `503 audio_backend_unavailable` with `Retry-After: 60` when no local node advertises audio transcription capability for local models.","requestBody":{"content":{"multipart/form-data":{"schema":{"properties":{"file":{"format":"binary","type":"string"},"language":{"type":"string"},"model":{"default":"terminaili/whisper","enum":["terminaili/whisper","parakeet-tdt-0.6b-v3","nvidia/parakeet-tdt-0.6b-v3"],"type":"string"},"prompt":{"type":"string"},"response_format":{"default":"json","enum":["json","text","srt","verbose_json","vtt"],"type":"string"},"temperature":{"maximum":2.0,"minimum":0.0,"type":"number"}},"required":["file"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudioTranscriptionJsonResponse"}},"application/x-subrip":{"schema":{"type":"string"}},"text/plain":{"schema":{"type":"string"}},"text/vtt":{"schema":{"type":"string"}}},"description":"Successful transcription. Body shape depends on `response_format`: JSON for json/verbose_json, plain text for text, SRT/VTT for the caption formats."},"400":{"description":"Validation error."},"401":{"description":"Authentication required."},"503":{"description":"No node in the fleet advertises audio transcription capability. Retry per Retry-After header. Error envelope: `{ error: { code: \"audio_backend_unavailable\", type: \"service_unavailable_error\" } }`."}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Transcribe audio to text"}},"/batches":{"get":{"parameters":[{"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchListResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"List your batch jobs"},"post":{"description":"Submits a batch of inference requests for asynchronous processing at a 50% per-token discount versus realtime. The input file must have been uploaded via POST /v1/files with purpose=batch. Each JSONL row is either an OpenAI-format chat-completions request ({custom_id, method, url, body: {model, messages, ...}}) or a legacy IPOP InferenceSubmitRequest. The default completion window is 24h.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBatchRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchJob"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Create a batch job from an uploaded JSONL file"}},"/batches/{batch_id}":{"get":{"parameters":[{"in":"path","name":"batch_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchDetailResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Read one batch job, including request_counts and the output file id when complete"}},"/batches/{batch_id}/cancel":{"post":{"parameters":[{"in":"path","name":"batch_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchJob"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Request cancellation of a running batch job"}},"/chat/completions":{"post":{"description":"OpenAI-compatible chat completions. Supports the `file_search` tool: send `tools: [{\"type\": \"file_search\"}]` plus `tool_resources.file_search.vector_store_ids` (≤ 4) to ground the response in your managed vector stores. Override the retrieval breadth with `tool_resources.file_search.max_num_results` (1–50, default 10). The retrieved chunks are advertised to the model as CANDIDATES — the model is instructed to ignore irrelevant passages and to cite chunk_id / file_id for any claim it draws from a retrieved passage.\n\n**Vision input**: pass an array as `messages[].content` mixing `{\"type\": \"text\", \"text\": ...}` and `{\"type\": \"image_url\", \"image_url\": {\"url\": ..., \"detail\": ...}}` parts. The platform checks the resolved model's `supports_vision` (via catalog `selector_tags` containing `vision` / `multimodal` / `vlm`, or the model id matching same). Non-vision routes return 400 `model_does_not_support_vision` rather than silently stripping image parts.\n\n**Structured outputs**: pass `response_format: {\"type\": \"json_schema\", \"json_schema\": {\"strict\": true, \"schema\": {...}}}` to request schema-constrained output. The platform validates the request shape (rejects malformed json_schema bodies at 400) and consults the resolved model's `supports_json_schema` signal — non-strict-capable routes return 400 `model_does_not_support_json_schema` rather than silently forwarding the strict request to a model with no enforcement.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletionResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"Create a chat completion"}},"/client-config/hermes":{"get":{"parameters":[{"description":"Return a shareable config copy without raw secrets.","in":"query","name":"redact_secrets","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentClientConfigResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Generate Hermes client configuration"}},"/client-config/hermes/freshness":{"get":{"parameters":[{"in":"query","name":"fingerprint","required":true,"schema":{"type":"string"}},{"in":"query","name":"selected_model_id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentClientConfigFreshnessResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Check Hermes client configuration freshness"}},"/client-config/opencode":{"get":{"parameters":[{"description":"Return a shareable config copy without raw secrets.","in":"query","name":"redact_secrets","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentClientConfigResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Generate OpenCode client configuration"}},"/client-config/opencode/freshness":{"get":{"parameters":[{"in":"query","name":"fingerprint","required":true,"schema":{"type":"string"}},{"in":"query","name":"selected_model_id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentClientConfigFreshnessResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Check OpenCode client configuration freshness"}},"/embeddings":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingsRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingsResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"Create embeddings"}},"/estimate":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EstimateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EstimateResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"Estimate tokens and cost"}},"/files":{"get":{"parameters":[{"in":"query","name":"purpose","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileListResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"List your uploaded files"},"post":{"description":"Uploads raw bytes to be referenced by a later batch or fine-tune job. The `purpose` query parameter selects the storage purpose ('batch', 'fine-tune', etc.). The request body is the raw file bytes; set Content-Type to application/octet-stream.","parameters":[{"in":"query","name":"purpose","required":false,"schema":{"type":"string"}},{"in":"query","name":"filename","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/octet-stream":{"schema":{"format":"binary","type":"string"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Upload a file (batch input, fine-tune training data)"}},"/files/{file_id}":{"delete":{"parameters":[{"in":"path","name":"file_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"File not found"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Delete one uploaded file"},"get":{"parameters":[{"in":"path","name":"file_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Read one uploaded file's metadata"}},"/files/{file_id}/content":{"get":{"parameters":[{"in":"path","name":"file_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/octet-stream":{"schema":{"format":"binary","type":"string"}}},"description":"Raw file content"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"File not found"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Download the raw bytes of an uploaded file"}},"/fine_tuning/jobs":{"get":{"parameters":[{"in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FineTuneJobListResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"List your fine-tune jobs"},"post":{"description":"Submits a LoRA fine-tune. `training_file` must be a file uploaded via POST /v1/files with purpose=fine-tune. `model` must be a catalog id whose entry is opted in for fine-tuning (`trainable=true`). The resulting fine-tune model id is `ft:<base>:u_<user>:<suffix>` for user-scoped results or `ft:<base>:p_<project>:<suffix>` for project-scoped. The fine-tune is invokable through /v1/chat/completions using the returned id — the control plane streams the LoRA adapter to the serving node automatically.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFineTuneJobRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FineTuneJob"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Create a fine-tune job (LoRA) against a trainable base model"}},"/fine_tuning/jobs/{job_id}":{"get":{"parameters":[{"in":"path","name":"job_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FineTuneJob"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Read one fine-tune job"}},"/fine_tuning/jobs/{job_id}/cancel":{"post":{"parameters":[{"in":"path","name":"job_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FineTuneJob"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Request cancellation of a fine-tune job"}},"/hosted-apps/{app_id}/deployments/{deployment_id}/promote":{"post":{"parameters":[{"in":"path","name":"app_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"deployment_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Promote a preview hosted app deployment to production"}},"/hosted-apps/{app_id}/deployments/{deployment_id}/rollback":{"post":{"parameters":[{"in":"path","name":"app_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"deployment_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Create a new hosted app deployment from a previous deployment"}},"/hosted-apps/{app_id}/domains":{"get":{"parameters":[{"in":"path","name":"app_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"List hosted app domains"},"post":{"parameters":[{"in":"path","name":"app_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Register a hosted app custom domain"}},"/hosted-apps/{app_id}/domains/{domain}":{"delete":{"parameters":[{"in":"path","name":"app_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"domain","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Delete a hosted app custom domain"}},"/images/generations":{"post":{"description":"OpenAI-compatible image generation endpoint for OpenRouter image-output models. `grok-imagine-image-quality` is routed through OpenRouter chat completions with image modalities and returns either data URLs (`response_format=url`) or raw base64 (`response_format=b64_json`). External-provider processing must be enabled for the API key.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageGenerationRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageGenerationResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Generate images"}},"/inference/{request_id}/attestation":{"get":{"description":"Late-binding retrieval for surfaces that strip non-OpenAI response fields. Returns 404 when the request didn't carry a `require_region` pin, hasn't completed, or doesn't belong to the caller. Verification: look up `signer_kid` in /v1/regions/keys, reconstruct canonical bytes (envelope with `signature_b64` blanked, serde_json serialized), Ed25519-verify against `signature_b64`.","parameters":[{"in":"path","name":"request_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegionAttestationEnvelope"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Retrieve the signed region-attestation envelope for a completed request"}},"/kv":{"get":{"description":"Use KV from server-side code only. A project API key can call KV, but storage is account and billing scoped; namespace project data such as projects/{project_id}/settings/theme.","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KvSummary"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Read the caller's private KV table summary, billing allowance, and usage"}},"/kv/items":{"get":{"description":"Lists metadata by default. Pass include_values=true from trusted server-side code when the response should include JSON values or base64 bytes.","parameters":[{"in":"query","name":"prefix","required":false,"schema":{"maxLength":512,"type":"string"}},{"in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":500,"minimum":1,"type":"integer"}},{"in":"query","name":"include_values","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KvList"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"List keys in the caller's private KV table"},"put":{"description":"Create or update JSON values or base64 bytes from server-side app code. Use ttl_seconds for expiry, create_only for first-writer-wins inserts, and if_version for optimistic concurrency.","requestBody":{"content":{"application/json":{"examples":{"base64_bytes":{"summary":"Binary payload encoded as base64","value":{"content_type":"application/octet-stream","key":"projects/proj_123/assets/logo","value_base64":"aGVsbG8="}},"json":{"summary":"Project-scoped JSON value with TTL","value":{"create_only":true,"key":"projects/proj_123/settings/theme","ttl_seconds":86400,"value":{"mode":"dark"}}},"optimistic_update":{"summary":"Version-guarded JSON update","value":{"if_version":3,"key":"projects/proj_123/settings/theme","value":{"mode":"light"}}}},"schema":{"$ref":"#/components/schemas/KvPutRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KvItem"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Create or update one KV item"}},"/kv/items/{key}":{"delete":{"description":"Delete one key, optionally guarded by if_version for optimistic concurrency.","parameters":[{"in":"path","name":"key","required":true,"schema":{"maxLength":512,"type":"string"}},{"in":"query","name":"if_version","required":false,"schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KvItem"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Delete one KV item by key"},"get":{"description":"Read a JSON value or base64 byte payload from trusted server-side code.","parameters":[{"in":"path","name":"key","required":true,"schema":{"maxLength":512,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KvItem"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Read one KV item by key"}},"/media/assets":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaAssetList"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"List media assets"},"post":{"parameters":[{"in":"header","name":"x-project-id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaAssetCreateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaAssetCreateResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Create a media asset and upload URL"}},"/media/assets/{asset_id}":{"delete":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaAsset"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Delete one media asset"},"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaAsset"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Get one media asset"},"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}}],"patch":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaAssetPatchRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaAsset"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Update media asset metadata"}},"/media/assets/{asset_id}/reprocess":{"post":{"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaAsset"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Queue media asset reprocessing"}},"/media/assets/{asset_id}/signed-url":{"post":{"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaSignedUrlRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaSignedUrlResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Create a signed private media delivery URL"}},"/media/assets/{asset_id}/source":{"put":{"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"expires","required":false,"schema":{"type":"integer"}},{"in":"query","name":"upload_token","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/octet-stream":{"schema":{"format":"binary","type":"string"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaAsset"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Upload a media source object"}},"/media/assets/{asset_id}/uploads/multipart":{"post":{"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaMultipartInitiateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaMultipartUpload"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Start a media multipart upload"}},"/media/assets/{asset_id}/uploads/multipart/{upload_id}":{"delete":{"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"upload_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaMultipartUpload"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Abort a media multipart upload"}},"/media/assets/{asset_id}/uploads/multipart/{upload_id}/complete":{"post":{"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"upload_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaMultipartCompleteRequest"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaAsset"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Complete a media multipart upload"}},"/media/assets/{asset_id}/uploads/multipart/{upload_id}/parts":{"post":{"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"upload_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"part_number","required":false,"schema":{"minimum":1,"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaMultipartPartUrlsRequest"}},"application/octet-stream":{"schema":{"format":"binary","type":"string"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaMultipartPartResult"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Upload one local multipart part or create provider part URLs"}},"/media/images/{asset_id}":{"get":{"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"w","required":false,"schema":{"minimum":1,"type":"integer"}},{"in":"query","name":"h","required":false,"schema":{"minimum":1,"type":"integer"}},{"in":"query","name":"fit","required":false,"schema":{"type":"string"}},{"in":"query","name":"format","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaBinaryResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"Deliver a transformed image"}},"/media/images/{asset_id}/variants/{variant}":{"get":{"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"variant","required":true,"schema":{"enum":["avatar","thumb","card","hero"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaBinaryResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"Deliver a named image variant"}},"/media/usage":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaUsage"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Read media usage and queue summary"}},"/media/videos/{asset_id}/manifest.m3u8":{"get":{"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaBinaryResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"Deliver a processed video HLS manifest"}},"/media/videos/{asset_id}/poster.jpg":{"get":{"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaBinaryResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"Deliver a processed video poster"}},"/media/videos/{asset_id}/renditions/{rendition}/{file}":{"get":{"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"rendition","required":true,"schema":{"type":"string"}},{"in":"path","name":"file","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaBinaryResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"Deliver a processed video rendition file"}},"/media/videos/{asset_id}/thumbs/{name}":{"get":{"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MediaBinaryResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"Deliver a processed video thumbnail"}},"/model-recommendations":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelRecommendationRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelRecommendationResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"Recommend public models for a task"}},"/models":{"get":{"parameters":[{"description":"Include the full public catalog, including models that are not currently usable.","in":"query","name":"include_unavailable","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Return only models with ready capacity now.","in":"query","name":"ready","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelList"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"List currently usable public models"}},"/models/{model_id}":{"get":{"parameters":[{"in":"path","name":"model_id","required":true,"schema":{"enum":["ipop/coder-balanced","claude-sonnet-4.6","grok-build-0.1","step-3.7-flash","claude-opus-4.8-fast","claude-opus-4.8","openai/gpt-5.5","openai/gpt-5.4","grok-4.3","gemini-3.5-flash","qwen3.7-max","openai/gpt-5.4-mini","deepseek-v4-pro","qwen3-235b-a22b-thinking-2507","openai/gpt-5-nano","gemini-3.1-flash-lite","kimi-k2.6","deepseek-v4-flash","mistral-small-2603","codestral-2508","ling-2.6-flash"],"type":"string"}},{"description":"Allow reading full-catalog model details for models that are not currently usable.","in":"query","name":"include_unavailable","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Return the model only when it has ready capacity now.","in":"query","name":"ready","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"Get one currently usable public model"}},"/openapi.json":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiDocument"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"Read the public OpenAPI contract"}},"/orchestrations":{"get":{"parameters":[{"in":"query","name":"workspace_id","required":false,"schema":{"type":"string"}},{"in":"query","name":"status","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationsListResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"List hosted multi-agent orchestrations"},"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationCreateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationRun"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Create a hosted multi-agent orchestration"}},"/orchestrations/{id}":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationRun"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Get a hosted orchestration"}},"/orchestrations/{id}/artifacts":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationArtifactsResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"List hosted orchestration artifacts"}},"/orchestrations/{id}/cancel":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationRun"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Cancel a hosted orchestration"}},"/orchestrations/{id}/candidates":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationCandidatesResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"List hosted orchestration candidates"}},"/orchestrations/{id}/events":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationEventsResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Replay hosted orchestration events"}},"/orchestrations/{id}/locks":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationLocksResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"List hosted orchestration path locks"}},"/orchestrations/{id}/merge":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MergeDecision"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Request hosted orchestration merge arbitration"}},"/orchestrations/{id}/tasks":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationTasksResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"List hosted orchestration tasks"}},"/orchestrations/{id}/tasks/{task_id}/retry":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"task_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationRun"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Retry an eligible hosted orchestration role task"}},"/orchestrations/{id}/undo":{"post":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrationUndoResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Request hosted orchestration merge undo"}},"/platform/auth/trial/vscode":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VscodeTrialRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VscodeTrialResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"Start an anonymous VS Code extension trial when trials are enabled"}},"/projects/{project_id}/app-config":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Read Project app configuration and secret setup hints"}},"/projects/{project_id}/box":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoxSummary"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Read Project Box documents, usage, and recent query history"}},"/projects/{project_id}/box/documents":{"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoxDocumentUploadRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoxDocumentCreateResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Upload a Project Box document for indexing"}},"/projects/{project_id}/box/documents/{document_id}":{"delete":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoxDocument"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Delete a Project Box document from retrieval"},"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoxDocumentDetail"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Read a Project Box document and ingestion jobs"},"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"document_id","required":true,"schema":{"type":"string"}}]},"/projects/{project_id}/box/documents/{document_id}/chunks/{chunk_id}":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"document_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"chunk_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoxChunkDetail"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Read one retrieved Project Box chunk"}},"/projects/{project_id}/box/documents/{document_id}/reindex":{"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"document_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoxDocument"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Queue a Project Box document for reindexing"}},"/projects/{project_id}/box/documents/{document_id}/source":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"document_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoxBinaryResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Download a Project Box source document"}},"/projects/{project_id}/box/query":{"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoxQueryRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoxQueryResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Ask a question over indexed Project Box documents"}},"/projects/{project_id}/cron":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"List project cron schedules"},"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Create a project cron schedule"}},"/projects/{project_id}/databases":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"List project Postgres database handoffs"},"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Attach or provision a project Postgres database and write DATABASE_URL to Project Secrets"}},"/projects/{project_id}/databases/{database_id}":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"database_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Read a project Postgres database handoff"}},"/projects/{project_id}/databases/{database_id}/attach-hosted-app":{"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"database_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Attach a Postgres handoff to a hosted app"}},"/projects/{project_id}/databases/{database_id}/rotate-credentials":{"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"database_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Rotate project Postgres credentials and update DATABASE_URL"}},"/projects/{project_id}/events":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Read the project event catalog and recent events"}},"/projects/{project_id}/inference-policy":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentCapturePolicy"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Read the inference content capture policy for a project"},"put":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentCapturePolicy"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentCapturePolicy"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Update the inference content capture policy for a project"}},"/projects/{project_id}/job-runs":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"List project job runs"}},"/projects/{project_id}/job-runs/{run_id}":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Read a project job run"}},"/projects/{project_id}/job-runs/{run_id}/retry":{"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Retry a project job run"}},"/projects/{project_id}/jobs":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"List project job definitions"},"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Create a project job definition"}},"/projects/{project_id}/jobs/{job_id}/runs":{"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"job_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Queue a manual project job run"}},"/projects/{project_id}/queues/{queue_name}/messages":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"queue_name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"List project queue messages"},"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"queue_name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Enqueue a project queue message"}},"/projects/{project_id}/secrets":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSecret"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"List Project Secrets metadata without raw values"}},"/projects/{project_id}/secrets/{name}":{"delete":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSecret"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Delete a Project Secret"},"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"name","required":true,"schema":{"type":"string"}}],"put":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSecretUpsertRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSecret"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Create or rotate a Project Secret"}},"/projects/{project_id}/webhook-deliveries":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"List project webhook delivery attempts"}},"/projects/{project_id}/webhook-deliveries/{delivery_id}/replay":{"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"delivery_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Replay a project webhook delivery"}},"/projects/{project_id}/webhooks":{"get":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"List project webhooks"},"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Create a project webhook"}},"/projects/{project_id}/webhooks/{webhook_id}/disable":{"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"webhook_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Disable a project webhook"}},"/projects/{project_id}/webhooks/{webhook_id}/rotate-secret":{"post":{"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"webhook_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LabsObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"BearerApiKey":[]}],"summary":"Rotate a project webhook signing secret"}},"/ready":{"get":{"parameters":[{"description":"Include the full public catalog in the readiness model list.","in":"query","name":"include_unavailable","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Return only models with ready capacity now.","in":"query","name":"ready","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReady"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"Get first-request readiness and copy-paste health checks"}},"/regions":{"get":{"description":"Returns one entry per region with at least one online, admin-approved node. Capacity is reported as a coarse bucket — None | Low (1-2 nodes) | Medium (3-9) | High (10+) — never exact counts. Authenticated callers additionally see the union of model ids available in each region; anonymous callers see only the region id and bucket. Pair with /v1/regions/keys to bootstrap offline attestation verification.","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegionCatalogResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[],"summary":"List geographic regions with admin-approved capacity"}},"/regions/keys":{"get":{"description":"Returns the Ed25519 public keys customers use to verify region-attestation envelopes offline. Only nodes with an admin-approved region are listed. `kid` identifies the keypair; the same kid is set on every envelope that node signs.","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegionAttestationKeysResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[],"summary":"JWKS-style bundle of node region-signing public keys"}},"/request-history":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestHistoryList"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"List sanitized request history"}},"/request-history/export":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestHistoryList"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"Export sanitized request history"}},"/request-history/{request_id}":{"get":{"parameters":[{"in":"path","name":"request_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestHistoryRecord"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"Get a sanitized request history record"}},"/request-history/{request_id}/feedback":{"post":{"parameters":[{"in":"path","name":"request_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestFeedbackRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestFeedbackResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"Send request quality feedback"}},"/request-history/{request_id}/replay":{"post":{"parameters":[{"in":"path","name":"request_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletionResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"Replay a retained request through the same public model"}},"/responses":{"post":{"description":"OpenAI-compatible Responses API surface backed by the IPOP router. Supports text and image input parts, function tools, file_search over managed vector stores, structured text formats, previous_response_id continuity, and typed server-sent events when stream=true. Unsupported built-in tools return stable request errors.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponsesCreateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"Create a response"}},"/responses/input_tokens":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseInputTokensRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseInputTokensResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"Count Responses API input tokens"}},"/responses/{response_id}":{"delete":{"parameters":[{"in":"path","name":"response_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseDeleted"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"Delete a stored response"},"get":{"parameters":[{"in":"path","name":"response_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"Retrieve a stored response"}},"/responses/{response_id}/cancel":{"post":{"parameters":[{"in":"path","name":"response_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseObject"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"Cancel a background response"}},"/responses/{response_id}/input_items":{"get":{"parameters":[{"in":"path","name":"response_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"after","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":20,"maximum":100,"minimum":1,"type":"integer"}},{"in":"query","name":"order","required":false,"schema":{"default":"asc","enum":["asc","desc"],"type":"string"}},{"in":"query","name":"include","required":false,"schema":{"items":{"$ref":"#/components/schemas/ResponseIncludeValue"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseInputItemList"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"List response input items"}},"/solana-rpc/methods":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolanaRpcMethodCatalog"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"List tested Solana RPC HTTP methods for the configured upstream"}},"/solana-rpc/plans":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolanaRpcCatalog"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"List Solana RPC access plans"}},"/solana-rpc/{network}":{"post":{"parameters":[{"in":"path","name":"network","required":true,"schema":{"enum":["mainnet","devnet"],"type":"string"}},{"description":"Optional Helius-style API key for clients that accept only a single RPC URL. Header auth is still recommended for backend services.","in":"query","name":"api-key","required":false,"schema":{"format":"password","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolanaJsonRpcRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolanaJsonRpcResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Proxy a Solana JSON-RPC request through the configured downstream RPC node"}},"/status":{"get":{"parameters":[{"description":"Include the full public catalog in the status model list.","in":"query","name":"include_unavailable","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Return only models with ready capacity now.","in":"query","name":"ready","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicStatus"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"summary":"Get launch model availability"}},"/storage":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObjectStorageSummary"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Read Object Storage allocation, buckets, and storage keys"}},"/storage/allocations":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObjectStorageAllocationCreateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObjectStorageAllocation"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Buy Object Storage TB-month allocation blocks with API credits"}},"/storage/s3/{bucket}/{key}":{"delete":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObjectStorageS3Response"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AwsSigV4":[]}],"summary":"Delete an object through the S3-compatible path-style gateway"},"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObjectStorageS3Response"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AwsSigV4":[]}],"summary":"Read an object through the S3-compatible path-style gateway"},"head":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObjectStorageS3Response"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AwsSigV4":[]}],"summary":"Read object metadata through the S3-compatible path-style gateway"},"parameters":[{"in":"path","name":"bucket","required":true,"schema":{"type":"string"}},{"in":"path","name":"key","required":true,"schema":{"type":"string"}}],"put":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObjectStorageS3Response"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"AwsSigV4":[]}],"summary":"Write an object through the S3-compatible path-style gateway"}},"/usage":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageSummary"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"List usage records"}},"/usage/export":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageSummary"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]}],"summary":"Export sanitized usage records"}},"/vector_stores":{"get":{"description":"Returns the most recent vector stores belonging to the calling project (or user, for legacy keys). Soft-deleted and expired stores are omitted. Use the `limit` query param to cap the page size (default 20, max 100).","parameters":[{"in":"query","name":"limit","required":false,"schema":{"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorStoreListResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"List the caller's vector stores"},"post":{"description":"Creates a new store. Attached files are chunked + indexed for retrieval via /v1/vector_stores/{id}/search and the `file_search` chat tool. Cross-tenant access is denied; project-scoped stores are visible to every API key in the same project.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateVectorStoreRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorStore"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Create a managed vector store"}},"/vector_stores/{vector_store_id}":{"delete":{"description":"Marks the store deleted_at, drops attachment rows and all chunks. Source files in /v1/files are untouched.","parameters":[{"in":"path","name":"vector_store_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorStore"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Soft-delete a vector store"},"get":{"parameters":[{"in":"path","name":"vector_store_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorStore"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Retrieve a vector store"},"post":{"description":"Updates mutable fields (name, metadata, expires_at). `expires_at` uses double-Option semantics: omit to leave unchanged, `null` to clear, an ISO-8601 timestamp to set.","parameters":[{"in":"path","name":"vector_store_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateVectorStoreRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorStore"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Modify a vector store"}},"/vector_stores/{vector_store_id}/files":{"get":{"parameters":[{"in":"path","name":"vector_store_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorStoreFileListResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"List files attached to a vector store"},"post":{"description":"Attaches a file previously uploaded via POST /v1/files with `purpose=assistants`. The returned `VectorStoreFile` carries `status=in_progress` immediately — chunking + indexing run in a background tokio task. Customers poll `GET /v1/vector_stores/{id}/files/{file_id}` until `status` becomes `completed` (success) or `failed` (storage error / oversized input / etc., with `last_error` set). Background tasks abandoned past the 600-second stall threshold (API restart, panic) get swept to `failed` by the periodic reconciler — the poll loop always terminates. Idempotent: re-attaching the same file returns the existing row.","parameters":[{"in":"path","name":"vector_store_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttachVectorStoreFileRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorStoreFile"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Attach a file to a vector store"}},"/vector_stores/{vector_store_id}/files/{file_id}":{"delete":{"description":"Removes the attachment and cascades chunk deletes. The source file in /v1/files is untouched.","parameters":[{"in":"path","name":"vector_store_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"file_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Attachment removed."},"400":{"description":"Validation error."},"401":{"description":"Authentication required."},"403":{"description":"Forbidden."},"404":{"description":"Not found."}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Detach a file from a vector store"},"get":{"parameters":[{"in":"path","name":"vector_store_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"file_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorStoreFile"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Retrieve a vector store attachment"}},"/vector_stores/{vector_store_id}/reindex":{"post":{"description":"Re-reads each attached file from storage and re-chunks/re-indexes it under the lock. Use after changing the embedding model on the store or after a chunking-algorithm upgrade. Per-file storage failures are caught: that attachment is marked `status=failed` with `last_error` set, but the rest of the reindex continues. Returns the post-reindex store object.","parameters":[{"in":"path","name":"vector_store_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorStore"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Rebuild the chunk index for every attached file"}},"/vector_stores/{vector_store_id}/search":{"post":{"description":"Returns the top chunks matching the query, ranked by relevance. v1 uses lexical scoring (distinct-term-aware, length-normalized); the dense-embedding upgrade swaps the scorer in place without changing the surface. Useful for diagnostics and SDKs that prefer to do their own prompt orchestration; the `file_search` chat tool calls this internally during /v1/chat/completions.","parameters":[{"in":"path","name":"vector_store_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorStoreSearchRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VectorStoreSearchResponse"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Search a vector store directly"}},"/videos":{"post":{"description":"Create an asynchronous OpenRouter video generation job. `grok-imagine-video` supports text-to-video and optional image/reference inputs. The response includes a local `/v1/videos/{job_id}` polling URL.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoGenerationRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoGenerationJob"}}},"description":"Video generation job accepted."},"400":{"description":"Validation error."},"401":{"description":"Authentication required."},"402":{"description":"Prepaid credits required."},"403":{"description":"External processing is disabled for the API key."},"503":{"description":"OpenRouter is unavailable or not configured."}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Create a video generation job"}},"/videos/{job_id}":{"get":{"description":"Poll an OpenRouter video generation job created by the same project. Completed jobs include `unsigned_urls` when OpenRouter returns downloadable video content.","parameters":[{"in":"path","name":"job_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoGenerationJob"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid public request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment required"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model or capacity unavailable"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Temporarily unavailable"}},"security":[{"ApiKey":[]},{"BearerApiKey":[]}],"summary":"Poll a video generation job"}}},"servers":[{"url":"/v1"}],"x-public-failure-codes":["bad_request","capacity_unavailable","context_length_exceeded","model_not_allowed","model_unavailable","payment_required","policy_violation","rate_limit_exceeded","service_unavailable","unauthorized"],"x-public-model-ids":["ipop/coder-balanced","claude-sonnet-4.6","grok-build-0.1","step-3.7-flash","claude-opus-4.8-fast","claude-opus-4.8","openai/gpt-5.5","openai/gpt-5.4","grok-4.3","gemini-3.5-flash","qwen3.7-max","openai/gpt-5.4-mini","deepseek-v4-pro","qwen3-235b-a22b-thinking-2507","openai/gpt-5-nano","gemini-3.1-flash-lite","kimi-k2.6","deepseek-v4-flash","mistral-small-2603","codestral-2508","ling-2.6-flash"]}