{"openapi":"3.1.0","info":{"title":"Fictix API","description":"Company simulation infrastructure — deterministic, correlated synthetic data across the connector surfaces declared by the capability manifest. Build repeatable demos, integration tests, and agent evaluations without using customer production data.","version":"1.0.0"},"paths":{"/api/v1/execute":{"post":{"tags":["execute"],"summary":"Execute Capability","description":"Execute a capability against synthetic demo data.\n\nThis endpoint implements the Fictix capability execution contract for\ngenerated company data.\n\nArgs:\n    request: ToolExecutionRequest with capability_key, org_id, user_id, turn_id, args.\n    x_api_key: API key for authentication (X-API-Key header).\n    x_session_id: Optional session ID for correlation (X-Session-ID header).\n\nReturns:\n    ToolExecutionResponse (success) or ErrorResponse (error).","operationId":"execute_capability_api_v1_execute_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-session-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"X-Session-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolExecutionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ToolExecutionResponse"},{"$ref":"#/components/schemas/ErrorResponse"}],"title":"Response Execute Capability Api V1 Execute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/health":{"get":{"tags":["execute"],"summary":"Health Check","description":"Health check endpoint.\n\nReturns:\n    HealthResponse with status, version, and capability count.","operationId":"health_check_api_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/api/v1/generate":{"post":{"tags":["generate","generate"],"summary":"Generate Data","description":"Generate synthetic data and return summary as JSON.","operationId":"generate_data_api_v1_generate_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/generate/preview":{"post":{"tags":["generate","generate"],"summary":"Generate Preview","description":"Generate a small preview of data.","operationId":"generate_preview_api_v1_generate_preview_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/generate/model/preview":{"post":{"tags":["generate","generate"],"summary":"Preview Model Generation","description":"Preview what will be generated based on DataModel.","operationId":"preview_model_generation_api_v1_generate_model_preview_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/generate/model":{"post":{"tags":["generate","generate"],"summary":"Generate From Model","description":"Generate data based on DataModel (async).","operationId":"generate_from_model_api_v1_generate_model_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/generate/model/{job_id}/status":{"get":{"tags":["generate","generate"],"summary":"Get Model Generation Status","description":"Get model-based generation job status.","operationId":"get_model_generation_status_api_v1_generate_model__job_id__status_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/generate/model/{job_id}/download":{"get":{"tags":["generate","generate"],"summary":"Download Generated Data","operationId":"download_generated_data_api_v1_generate_model__job_id__download_get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"csv","title":"Format"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/generate":{"post":{"tags":["generate","generate"],"summary":"Generate Project Data","description":"Generate data for a project.\n\nRuns the full three-layer engine: L1 financial, L2 operational, L3 content.\nOptionally specify `connectors` to limit which projection views are built.","operationId":"generate_project_data_api_v1_projects__project_id__generate_post","deprecated":true,"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"X-Credit-Run-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Credit-Run-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateProjectDataRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/connectors":{"get":{"tags":["generate","generate"],"summary":"List Connectors","description":"List real service families and their materialization support.","operationId":"list_connectors_api_v1_connectors_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/company-blueprints/resolve":{"post":{"tags":["projects","projects"],"summary":"Resolve Company Blueprint","operationId":"resolve_company_blueprint_api_v1_company_blueprints_resolve_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyBlueprintResolveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects":{"post":{"tags":["projects","projects"],"summary":"Create Project","operationId":"create_project_api_v1_projects_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProjectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["projects","projects"],"summary":"List Projects","operationId":"list_projects_api_v1_projects_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":300000,"minimum":0,"default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/bootstrap":{"post":{"tags":["projects","projects"],"summary":"Bootstrap Project","operationId":"bootstrap_project_api_v1_projects_bootstrap_post","parameters":[{"name":"X-Credit-Run-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Credit-Run-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BootstrapProjectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/generation-runs":{"post":{"tags":["projects","projects"],"summary":"Create Project Generation Run","operationId":"create_project_generation_run_api_v1_projects__project_ref__generation_runs_post","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"X-Credit-Run-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Credit-Run-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateProjectDataRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["projects","projects"],"summary":"List Project Generation Runs","operationId":"list_project_generation_runs_api_v1_projects__project_ref__generation_runs_get","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":300000,"minimum":0,"default":0,"title":"Offset"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/variants":{"post":{"tags":["projects","projects"],"summary":"Create Project Variant","operationId":"create_project_variant_api_v1_projects__project_ref__variants_post","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"X-Credit-Run-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Credit-Run-Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectVariantRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/runs":{"get":{"tags":["projects","projects"],"summary":"List Project Runs","operationId":"list_project_runs_api_v1_projects__project_ref__runs_get","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":300000,"minimum":0,"default":0,"title":"Offset"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/generation-runs/{run_id}":{"get":{"tags":["projects","projects"],"summary":"Get Project Generation Run","operationId":"get_project_generation_run_api_v1_projects__project_ref__generation_runs__run_id__get","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/generation-runs/{run_id}/start":{"post":{"tags":["projects","projects"],"summary":"Start Project Generation Run","operationId":"start_project_generation_run_api_v1_projects__project_ref__generation_runs__run_id__start_post","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/generation-runs/{run_id}/progress":{"get":{"tags":["projects","projects"],"summary":"Stream Project Generation Run Progress","operationId":"stream_project_generation_run_progress_api_v1_projects__project_ref__generation_runs__run_id__progress_get","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/customers/top":{"get":{"tags":["projects","projects"],"summary":"Get Top Project Customers","description":"Return top customers by invoice revenue using generated records.","operationId":"get_top_project_customers_api_v1_projects__project_ref__customers_top_get","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/aging":{"get":{"tags":["projects","projects"],"summary":"Get Project Aging","description":"Return AR or AP aging buckets from generated invoices or bills.","operationId":"get_project_aging_api_v1_projects__project_ref__aging_get","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","pattern":"^(ar|ap)$","default":"ar","title":"Type"}},{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/mrr":{"get":{"tags":["projects","projects"],"summary":"Get Project Mrr","description":"Return a conservative MRR waterfall from subscription records.","operationId":"get_project_mrr_api_v1_projects__project_ref__mrr_get","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/balance-sheet":{"get":{"tags":["projects","projects"],"summary":"Get Project Balance Sheet","description":"Return a balance-sheet snapshot from generated accounting data.","operationId":"get_project_balance_sheet_api_v1_projects__project_ref__balance_sheet_get","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/burn":{"get":{"tags":["projects","projects"],"summary":"Get Project Burn","description":"Return trailing burn and runway from generated cash/expense data.","operationId":"get_project_burn_api_v1_projects__project_ref__burn_get","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"window_months","in":"query","required":false,"schema":{"type":"integer","maximum":24,"minimum":1,"default":3,"title":"Window Months"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/pipeline":{"get":{"tags":["projects","projects"],"summary":"Get Project Pipeline","description":"Return CRM pipeline stage aggregates from generated deals.","operationId":"get_project_pipeline_api_v1_projects__project_ref__pipeline_get","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/coherence":{"get":{"tags":["projects","projects"],"summary":"Get Project Coherence","description":"Return record-derived cross-system reconciliation measurements.","operationId":"get_project_coherence_api_v1_projects__project_ref__coherence_get","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/scenarios/{scenario_id}/needles":{"get":{"tags":["projects","projects"],"summary":"Get Project Scenario Needles","description":"Return planted needles for one scenario from real manifests.","operationId":"get_project_scenario_needles_api_v1_projects__project_ref__scenarios__scenario_id__needles_get","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"scenario_id","in":"path","required":true,"schema":{"type":"string","title":"Scenario Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/seeds/{seed_hex}":{"get":{"tags":["projects","projects"],"summary":"Get Project By Seed","description":"Look up the latest project generation run created from a seed.","operationId":"get_project_by_seed_api_v1_seeds__seed_hex__get","parameters":[{"name":"seed_hex","in":"path","required":true,"schema":{"type":"string","title":"Seed Hex"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/publish":{"post":{"tags":["projects","projects"],"summary":"Publish Project","description":"Return or assign a short publish ID for PM->Engineer handoff.","operationId":"publish_project_api_v1_projects__project_ref__publish_post","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}":{"get":{"tags":["projects","projects"],"summary":"Get Project","description":"Get project details.","operationId":"get_project_api_v1_projects__project_id__get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["projects","projects"],"summary":"Delete Project","description":"Delete a project.","operationId":"delete_project_api_v1_projects__project_id__delete","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["projects","projects"],"summary":"Update Project","description":"Partially update project metadata and config.","operationId":"update_project_api_v1_projects__project_id__patch","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProjectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/archive":{"post":{"tags":["projects","projects"],"summary":"Archive Project","description":"Reversibly archive a project without deleting its data or credentials.","operationId":"archive_project_api_v1_projects__project_ref__archive_post","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_ref}/restore":{"post":{"tags":["projects","projects"],"summary":"Restore Project","description":"Restore a reversibly archived project to its prior lifecycle status.","operationId":"restore_project_api_v1_projects__project_ref__restore_post","parameters":[{"name":"project_ref","in":"path","required":true,"schema":{"type":"string","title":"Project Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/reset":{"post":{"tags":["projects","projects"],"summary":"Reset Project","description":"Reset project data and simulation state. Requires X-Confirm-Destructive: true.","operationId":"reset_project_api_v1_projects__project_id__reset_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/clone":{"post":{"tags":["projects","projects"],"summary":"Clone Project","description":"Clone a project with a new seed.","operationId":"clone_project_api_v1_projects__project_id__clone_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/api-keys":{"get":{"tags":["projects","projects"],"summary":"List Project Api Keys","description":"List API key metadata for a project (never returns raw keys).","operationId":"list_project_api_keys_api_v1_projects__project_id__api_keys_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"include_revoked","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Revoked"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["projects","projects"],"summary":"Create Project Api Key","description":"Issue a new API key for a project (plaintext returned once).\n\nMembers need this for runtime restore after the original bootstrap response is gone.\nKey listing, revocation, and rotation remain admin-only.","operationId":"create_project_api_key_api_v1_projects__project_id__api_keys_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAPIKeyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/api-keys/{key_id}/revoke":{"post":{"tags":["projects","projects"],"summary":"Revoke Project Api Key","description":"Revoke one API key for a project.","operationId":"revoke_project_api_key_api_v1_projects__project_id__api_keys__key_id__revoke_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/api-keys/{key_id}/rotate":{"post":{"tags":["projects","projects"],"summary":"Rotate Project Api Key","description":"Rotate a project API key (revoke old, issue new).","operationId":"rotate_project_api_key_api_v1_projects__project_id__api_keys__key_id__rotate_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/status":{"get":{"tags":["projects","projects"],"summary":"Get Project Status","description":"Get project generation status.","operationId":"get_project_status_api_v1_projects__project_id__status_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/quality":{"get":{"tags":["projects","projects"],"summary":"Get Project Quality","description":"Get data quality validation results for a project.","operationId":"get_project_quality_api_v1_projects__project_id__quality_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/certificate":{"get":{"tags":["projects","projects"],"summary":"Get Project Certificate","description":"Get the validation certificate for one generated project.","operationId":"get_project_certificate_api_v1_projects__project_id__certificate_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/runtime-readiness":{"get":{"tags":["projects","projects"],"summary":"Get Project Runtime Readiness","description":"Get explicit static/trickle/continuous readiness for one project.","operationId":"get_project_runtime_readiness_api_v1_projects__project_id__runtime_readiness_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/normalized-storage/health":{"get":{"tags":["projects","projects"],"summary":"Get Project Normalized Storage Health","description":"Report whether normalized shadow rows match project metadata counts.","operationId":"get_project_normalized_storage_health_api_v1_projects__project_id__normalized_storage_health_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/normalized-storage/rebuild":{"post":{"tags":["projects","projects"],"summary":"Rebuild Project Normalized Storage","description":"Rebuild normalized shadows from the current dataset blob.","operationId":"rebuild_project_normalized_storage_api_v1_projects__project_id__normalized_storage_rebuild_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/eval-pack-manifest":{"get":{"tags":["projects","projects"],"summary":"Get Project Eval Pack Manifest","description":"Get the shareable eval/data-pack contract for one generated project.","operationId":"get_project_eval_pack_manifest_api_v1_projects__project_id__eval_pack_manifest_get","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/projects/{project_id}/load":{"post":{"tags":["projects","projects"],"summary":"Load Project To Mock","description":"Load project data to a mock accounting API.\n\nTargets: qbo (localhost:9202), netsuite (localhost:9001), erpnext (localhost:9201).\nQuality: clean (0%), realistic (5%), messy (15%), garbage (30%).","operationId":"load_project_to_mock_api_v1_projects__project_id__load_post","parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/demo-jobs/discover":{"post":{"tags":["demo-jobs"],"summary":"Discover Demo Job Company","description":"Turn natural language into reviewable company truth and a create request.","operationId":"discover_demo_job_company_api_v1_demo_jobs_discover_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobDiscoveryRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobDiscoveryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs":{"get":{"tags":["demo-jobs"],"summary":"List Demo Jobs","description":"List partner-facing demo jobs.","operationId":"list_demo_jobs_api_v1_demo_jobs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":300000,"minimum":0,"default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]},"post":{"tags":["demo-jobs"],"summary":"Create Demo Job","description":"Create a new demo job and fully bootstrap the generated dataset.","operationId":"create_demo_job_api_v1_demo_jobs_post","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","title":"Idempotency-Key"}},{"name":"X-Credit-Run-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Credit-Run-Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobCreateResponse"}}}},"400":{"description":"The Idempotency-Key or create payload is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobErrorResponse"}}}},"401":{"description":"Management authentication is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobErrorResponse"}}}},"402":{"description":"A valid credit run or sufficient credits are required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobCreditErrorResponse"}}}},"403":{"description":"The caller cannot create jobs in the resolved tenant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobErrorResponse"}}}},"409":{"description":"The key, credit target, or original issuance conflicts.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/DemoJobErrorResponse"},{"$ref":"#/components/schemas/DemoJobCreditErrorResponse"}],"title":"Response 409 Create Demo Job Api V1 Demo Jobs Post"}}}},"422":{"description":"The request body or priced generation shape is invalid.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/DemoJobValidationErrorResponse"},{"$ref":"#/components/schemas/DemoJobCreditErrorResponse"}],"title":"Response 422 Create Demo Job Api V1 Demo Jobs Post"}}}},"429":{"description":"A generation, rate, plan, or concurrency limit was reached.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/DemoJobErrorResponse"},{"$ref":"#/components/schemas/DemoJobCreditErrorResponse"}],"title":"Response 429 Create Demo Job Api V1 Demo Jobs Post"}}}},"500":{"description":"An unexpected server failure occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobErrorResponse"}}}},"503":{"description":"Generation capacity, durable storage, or the current fenced owner is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobErrorResponse"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/stream":{"post":{"tags":["demo-jobs"],"summary":"Stream Demo Job","description":"Create one demo job while observing its real generator checkpoints.","operationId":"stream_demo_job_api_v1_demo_jobs_stream_post","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","title":"Idempotency-Key"}},{"name":"X-Credit-Run-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Credit-Run-Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobCreateRequest"}}}},"responses":{"200":{"description":"Server-sent events: ordered `stage` events carrying the real generator checkpoints, terminated by one `done` event holding the created demo job, or one `error` event.","content":{"text/event-stream":{"schema":{"type":"string","description":"SSE frames. `event: stage` data is {stage, percent, job_id}; `event: done` data is the demo job resource plus job_id; `event: error` data is {detail}."}}}},"401":{"description":"Management authentication is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}":{"get":{"tags":["demo-jobs"],"summary":"Get Demo Job","description":"Fetch normalized metadata for one demo job.","operationId":"get_demo_job_api_v1_demo_jobs__job_ref__get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJob"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/status":{"get":{"tags":["demo-jobs"],"summary":"Get Demo Job Status","description":"Return one polling-friendly status resource for a demo job.","operationId":"get_demo_job_status_api_v1_demo_jobs__job_ref__status_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/quality":{"get":{"tags":["demo-jobs"],"summary":"Get Demo Job Quality","description":"Return normalized validation results for one demo job.","operationId":"get_demo_job_quality_api_v1_demo_jobs__job_ref__quality_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobQuality"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/certificate":{"get":{"tags":["demo-jobs"],"summary":"Get Demo Job Certificate","description":"Return the validation certificate for one demo job.","operationId":"get_demo_job_certificate_api_v1_demo_jobs__job_ref__certificate_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationCertificate"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/runtime-readiness":{"get":{"tags":["demo-jobs"],"summary":"Get Demo Job Runtime Readiness","description":"Return explicit static/trickle/continuous readiness for one demo job.","operationId":"get_demo_job_runtime_readiness_api_v1_demo_jobs__job_ref__runtime_readiness_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeReadiness"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/eval-pack-manifest":{"get":{"tags":["demo-jobs"],"summary":"Get Demo Job Eval Pack Manifest","description":"Return the shareable eval/data-pack contract for one demo job.","operationId":"get_demo_job_eval_pack_manifest_api_v1_demo_jobs__job_ref__eval_pack_manifest_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalPackManifest"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/bundle":{"get":{"tags":["demo-jobs"],"summary":"Get Demo Job Bundle","description":"Return a normalized multi-entity bundle for one demo job.","operationId":"get_demo_job_bundle_api_v1_demo_jobs__job_ref__bundle_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Entity"}},{"name":"include_empty","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Empty"}},{"name":"max_records","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Max Records"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoBundle"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/entities/{entity}":{"get":{"tags":["demo-jobs"],"summary":"Get Demo Job Entity","description":"Return one paginated entity slice from a demo job.","operationId":"get_demo_job_entity_api_v1_demo_jobs__job_ref__entities__entity__get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"entity","in":"path","required":true,"schema":{"type":"string","title":"Entity"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":300000,"minimum":0,"default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoEntityPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/entities/{entity}/export":{"get":{"tags":["demo-jobs"],"summary":"Export Demo Job Entity","description":"Export one entity family from a demo job as JSON or CSV.","operationId":"export_demo_job_entity_api_v1_demo_jobs__job_ref__entities__entity__export_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"entity","in":"path","required":true,"schema":{"type":"string","title":"Entity"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(csv|json)$","default":"json","title":"Format"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoEntityExport"}},"text/csv":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/publish":{"post":{"tags":["demo-jobs"],"summary":"Publish Demo Job","description":"Publish a demo job for human-friendly handoff URLs.","operationId":"publish_demo_job_api_v1_demo_jobs__job_ref__publish_post","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJob"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/clone":{"post":{"tags":["demo-jobs"],"summary":"Clone Demo Job","description":"Clone one demo job into a fresh project with a new runtime key.","operationId":"clone_demo_job_api_v1_demo_jobs__job_ref__clone_post","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJob"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/reset":{"post":{"tags":["demo-jobs"],"summary":"Reset Demo Job","description":"Reset one demo job to a created state.","operationId":"reset_demo_job_api_v1_demo_jobs__job_ref__reset_post","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobResetRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoJobReset"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/simulation/start":{"post":{"tags":["demo-jobs"],"summary":"Start Demo Job Simulation","description":"Start or return the simulation state for one demo job.","operationId":"start_demo_job_simulation_api_v1_demo_jobs__job_ref__simulation_start_post","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulationState"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/simulation/status":{"get":{"tags":["demo-jobs"],"summary":"Get Demo Job Simulation Status","description":"Return current simulation status for one demo job.","operationId":"get_demo_job_simulation_status_api_v1_demo_jobs__job_ref__simulation_status_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulationState"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/simulation/advance":{"post":{"tags":["demo-jobs"],"summary":"Advance Demo Job Simulation","description":"Advance one demo-job simulation and materialize generated events.","operationId":"advance_demo_job_simulation_api_v1_demo_jobs__job_ref__simulation_advance_post","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvanceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulationAdvance"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/simulation/step":{"post":{"tags":["demo-jobs"],"summary":"Step Demo Job Simulation","description":"Advance one demo-job simulation by a fixed event count.","operationId":"step_demo_job_simulation_api_v1_demo_jobs__job_ref__simulation_step_post","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StepRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulationAdvance"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/simulation/pause":{"post":{"tags":["demo-jobs"],"summary":"Pause Demo Job Simulation","description":"Pause one demo-job simulation.","operationId":"pause_demo_job_simulation_api_v1_demo_jobs__job_ref__simulation_pause_post","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulationState"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/simulation/resume":{"post":{"tags":["demo-jobs"],"summary":"Resume Demo Job Simulation","description":"Resume one demo-job simulation under the server-owned trickle worker.","operationId":"resume_demo_job_simulation_api_v1_demo_jobs__job_ref__simulation_resume_post","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulationState"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/simulation/dials":{"patch":{"tags":["demo-jobs"],"summary":"Patch Demo Job Simulation Dials","description":"Update simulation dials for one demo job.","operationId":"patch_demo_job_simulation_dials_api_v1_demo_jobs__job_ref__simulation_dials_patch","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DialsPatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulationState"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/simulation/checkpoint":{"post":{"tags":["demo-jobs"],"summary":"Checkpoint Demo Job Simulation","description":"Create a checkpoint for one demo-job simulation.","operationId":"checkpoint_demo_job_simulation_api_v1_demo_jobs__job_ref__simulation_checkpoint_post","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckpointRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Checkpoint"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/simulation/checkpoints":{"get":{"tags":["demo-jobs"],"summary":"List Demo Job Simulation Checkpoints","description":"List checkpoints for one demo-job simulation.","operationId":"list_demo_job_simulation_checkpoints_api_v1_demo_jobs__job_ref__simulation_checkpoints_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckpointList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/simulation/restore/{checkpoint_id}":{"post":{"tags":["demo-jobs"],"summary":"Restore Demo Job Simulation","description":"Restore one demo-job simulation from a checkpoint.","operationId":"restore_demo_job_simulation_api_v1_demo_jobs__job_ref__simulation_restore__checkpoint_id__post","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"checkpoint_id","in":"path","required":true,"schema":{"type":"string","title":"Checkpoint Id"}},{"name":"x-confirm-destructive","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Confirm-Destructive"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulationState"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/scenarios":{"get":{"tags":["demo-jobs"],"summary":"List Demo Job Scenarios","description":"Return the built-in scenario template library for a demo job.","operationId":"list_demo_job_scenarios_api_v1_demo_jobs__job_ref__scenarios_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScenarioList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/simulation/configurations":{"get":{"tags":["demo-jobs"],"summary":"Get Demo Job Scenario Configurations","description":"Return only saved customer-selected scenario terms for a demo job.","operationId":"get_demo_job_scenario_configurations_api_v1_demo_jobs__job_ref__simulation_configurations_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScenarioConfigurationsV2Response"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/scenarios/generate":{"post":{"tags":["demo-jobs"],"summary":"Generate Demo Job Scenario","description":"Match plain English to a scenario template for one demo job.","operationId":"generate_demo_job_scenario_api_v1_demo_jobs__job_ref__scenarios_generate_post","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScenarioGenerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScenarioSuggestionList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/simulation/scenarios":{"post":{"tags":["demo-jobs"],"summary":"Inject Demo Job Scenarios","description":"Inject scenarios into one demo job and persist the ground-truth manifest.","operationId":"inject_demo_job_scenarios_api_v1_demo_jobs__job_ref__simulation_scenarios_post","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InjectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Scenario"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/simulation/manifest":{"get":{"tags":["demo-jobs"],"summary":"Get Demo Job Manifest","description":"Return the current ground-truth manifest for one demo job.","operationId":"get_demo_job_manifest_api_v1_demo_jobs__job_ref__simulation_manifest_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScenarioManifest"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/simulation/scenarios/{scenario_id}":{"delete":{"tags":["demo-jobs"],"summary":"Deactivate Demo Job Scenario","description":"Deactivate one scenario while retaining planted records for auditability.","operationId":"deactivate_demo_job_scenario_api_v1_demo_jobs__job_ref__simulation_scenarios__scenario_id__delete","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"scenario_id","in":"path","required":true,"schema":{"type":"string","title":"Scenario Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletedResource"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/events":{"get":{"tags":["demo-jobs"],"summary":"List Demo Job Events","description":"Return the cursor-paginated event stream for one demo job.","operationId":"list_demo_job_events_api_v1_demo_jobs__job_ref__events_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"asc","title":"Order"}},{"name":"event_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type"}},{"name":"entity_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"}},{"name":"entity_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Id"}},{"name":"correlation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Correlation Id"}},{"name":"after","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"After"}},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Before"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/events/{event_id}":{"get":{"tags":["demo-jobs"],"summary":"Get Demo Job Event","description":"Return one event and its causal chain for a demo job.","operationId":"get_demo_job_event_api_v1_demo_jobs__job_ref__events__event_id__get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"event_id","in":"path","required":true,"schema":{"type":"string","title":"Event Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Event"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/test-matrices":{"post":{"tags":["demo-jobs"],"summary":"Create Demo Job Matrix","description":"Create a test matrix for one demo job.","operationId":"create_demo_job_matrix_api_v1_demo_jobs__job_ref__test_matrices_post","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMatrixRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestMatrix"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]},"get":{"tags":["demo-jobs"],"summary":"List Demo Job Matrices","description":"List test matrices for one demo job.","operationId":"list_demo_job_matrices_api_v1_demo_jobs__job_ref__test_matrices_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestMatrixList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/test-matrices/{matrix_id}":{"get":{"tags":["demo-jobs"],"summary":"Get Demo Job Matrix","description":"Return one test matrix with latest run and short history.","operationId":"get_demo_job_matrix_api_v1_demo_jobs__job_ref__test_matrices__matrix_id__get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"matrix_id","in":"path","required":true,"schema":{"type":"string","title":"Matrix Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestMatrix"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]},"delete":{"tags":["demo-jobs"],"summary":"Delete Demo Job Matrix","description":"Delete one test matrix for a demo job.","operationId":"delete_demo_job_matrix_api_v1_demo_jobs__job_ref__test_matrices__matrix_id__delete","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"matrix_id","in":"path","required":true,"schema":{"type":"string","title":"Matrix Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletedResource"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/test-runs":{"post":{"tags":["demo-jobs"],"summary":"Submit Demo Job Test Run","description":"Submit detected findings and score them against a demo job answer key.","operationId":"submit_demo_job_test_run_api_v1_demo_jobs__job_ref__test_runs_post","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitTestRunRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestRun"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]},"get":{"tags":["demo-jobs"],"summary":"List Demo Job Test Runs","description":"List test runs for one demo-job matrix.","operationId":"list_demo_job_test_runs_api_v1_demo_jobs__job_ref__test_runs_get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"matrix_id","in":"query","required":true,"schema":{"type":"string","title":"Matrix Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestRunList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/demo-jobs/{job_ref}/test-runs/{run_id}":{"get":{"tags":["demo-jobs"],"summary":"Get Demo Job Test Run","description":"Return one test run for a demo job.","operationId":"get_demo_job_test_run_api_v1_demo_jobs__job_ref__test_runs__run_id__get","parameters":[{"name":"job_ref","in":"path","required":true,"schema":{"type":"string","title":"Job Ref"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestRun"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]},{"AdminApiKey":[]}]}},"/api/v1/catalog/archetypes":{"get":{"tags":["catalog"],"summary":"List Catalog Archetypes","description":"List supported company archetypes.","operationId":"list_catalog_archetypes_api_v1_catalog_archetypes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogCollection"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[]}},"/api/v1/catalog/presets":{"get":{"tags":["catalog"],"summary":"List Catalog Presets","description":"List supported quality presets.","operationId":"list_catalog_presets_api_v1_catalog_presets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogCollection"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[]}},"/api/v1/catalog/entities":{"get":{"tags":["catalog"],"summary":"List Catalog Entities","description":"List public entity families available through the demo-jobs contract.","operationId":"list_catalog_entities_api_v1_catalog_entities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogCollection"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[]}},"/api/v1/catalog/services":{"get":{"tags":["catalog"],"summary":"List Catalog Services","description":"List supported connector/service families and their visible record types.","operationId":"list_catalog_services_api_v1_catalog_services_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogCollection"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[]}},"/api/v1/catalog/connector-capabilities":{"get":{"tags":["catalog"],"summary":"List Catalog Connector Capabilities","description":"Return the UI-safe connector availability and fidelity manifest.","operationId":"list_catalog_connector_capabilities_api_v1_catalog_connector_capabilities_get","parameters":[{"name":"include_unsupported","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Unsupported"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogCollection"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[]}},"/api/v1/catalog/export-packs":{"get":{"tags":["catalog"],"summary":"List Catalog Export Packs","description":"List shipped manual CSV export packs.","operationId":"list_catalog_export_packs_api_v1_catalog_export_packs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogCollection"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[]}},"/api/v1/catalog/services/{service_id}/objects/{object_type}/schema":{"get":{"tags":["catalog"],"summary":"Get Catalog Object Schema","description":"Return UI column metadata for one service/object record surface.","operationId":"get_catalog_object_schema_api_v1_catalog_services__service_id__objects__object_type__schema_get","parameters":[{"name":"service_id","in":"path","required":true,"schema":{"type":"string","title":"Service Id"}},{"name":"object_type","in":"path","required":true,"schema":{"type":"string","title":"Object Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogObjectSchema"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[]}},"/api/v1/catalog/export-packs/qbo/schema":{"get":{"tags":["catalog"],"summary":"Get Catalog Qbo Export Schema","description":"Return the public QuickBooks export-pack schema for pre-bootstrap clients.","operationId":"get_catalog_qbo_export_schema_api_v1_catalog_export_packs_qbo_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogExportPackSchema"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[]}},"/api/v1/catalog/export-packs/{target}/schema":{"get":{"tags":["catalog"],"summary":"Get Catalog Export Pack Schema","description":"Return a public manual CSV export-pack schema by target.","operationId":"get_catalog_export_pack_schema_api_v1_catalog_export_packs__target__schema_get","parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogExportPackSchema"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[]}},"/api/v1/auth/login":{"get":{"tags":["auth"],"summary":"Workos Auth Login","description":"Redirect the browser to the hosted Fictix sign-in flow.","operationId":"workos_auth_login_api_v1_auth_login_get","parameters":[{"name":"next","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next"}},{"name":"screen_hint","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Screen Hint"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/staging-bypass":{"post":{"tags":["auth"],"summary":"Staging Bypass","description":"Create an automation-only signed staging customer session.","operationId":"staging_bypass_api_v1_auth_staging_bypass_post","parameters":[{"name":"X-Staging-Bypass-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Staging-Bypass-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/StagingBypassRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/callback":{"get":{"tags":["auth"],"summary":"Workos Auth Callback","description":"Exchange the AuthKit callback code and create a backend refresh cookie.","operationId":"workos_auth_callback_api_v1_auth_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/password":{"post":{"tags":["auth"],"summary":"Password Auth","description":"Authenticate an email/password user through WorkOS.","operationId":"password_auth_api_v1_auth_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordAuthRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordAuthResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/sign-up":{"post":{"tags":["auth"],"summary":"Sign Up","description":"Create a WorkOS user, then authenticate them for the app session.","operationId":"sign_up_api_v1_auth_sign_up_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignUpRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/email-verification":{"post":{"tags":["auth"],"summary":"Email Verification","description":"Complete a sign-in/sign-up WorkOS paused for email verification.","operationId":"email_verification_api_v1_auth_email_verification_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailVerificationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/email-verification/resend":{"post":{"tags":["auth"],"summary":"Resend Verification","description":"Re-send the WorkOS email verification code.","operationId":"resend_verification_api_v1_auth_email_verification_resend_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResendVerificationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/session":{"get":{"tags":["auth"],"summary":"Session","description":"Refresh and return the current customer session.","operationId":"session_api_v1_auth_session_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/logout":{"post":{"tags":["auth"],"summary":"Logout","description":"End the local app session and revoke the WorkOS session when possible.","operationId":"logout_api_v1_auth_logout_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/password-reset":{"post":{"tags":["auth"],"summary":"Password Reset","description":"Create a one-time reset link and deliver it to the account email.\n\nThe response is deliberately generic for known and unknown accounts.  A\npassword-reset URL is a bearer credential and must never be returned to the\nunauthenticated caller that requested it.","operationId":"password_reset_api_v1_auth_password_reset_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/password-reset/confirm":{"post":{"tags":["auth"],"summary":"Password Reset Confirm","description":"Confirm a WorkOS password reset token.","operationId":"password_reset_confirm_api_v1_auth_password_reset_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetConfirmRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auth/profile":{"patch":{"tags":["auth"],"summary":"Update Profile","description":"Update the current user's WorkOS display name.","operationId":"update_profile_api_v1_auth_profile_patch","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations":{"post":{"tags":["organizations","organizations"],"summary":"Create Organization","description":"Create a new top-level organization/workspace.","operationId":"create_organization_api_v1_organizations_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrganizationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["organizations","organizations"],"summary":"List Organizations","description":"List organizations.","operationId":"list_organizations_api_v1_organizations_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":300000,"minimum":0,"default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}":{"get":{"tags":["organizations","organizations"],"summary":"Get Organization","description":"Get one organization with linked project count.","operationId":"get_organization_api_v1_organizations__org_id__get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["organizations","organizations"],"summary":"Update Organization","description":"Update mutable organization fields.","operationId":"update_organization_api_v1_organizations__org_id__patch","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOrganizationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["organizations","organizations"],"summary":"Delete Organization","description":"Delete organization when it has no projects.","operationId":"delete_organization_api_v1_organizations__org_id__delete","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/browser-origins":{"get":{"tags":["organizations","organizations","native"],"summary":"Get Native Browser Origins","description":"List exact origins allowed to receive short-lived native API tokens.","operationId":"get_native_browser_origins_api_v1_organizations__org_id__browser_origins_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["organizations","organizations","native"],"summary":"Replace Native Browser Origins","description":"Replace the native-browser allowlist; removal revokes origin-bound tokens.","operationId":"replace_native_browser_origins_api_v1_organizations__org_id__browser_origins_put","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NativeBrowserOriginsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/projects":{"get":{"tags":["organizations","organizations"],"summary":"List Organization Projects","description":"List projects under an organization.","operationId":"list_organization_projects_api_v1_organizations__org_id__projects_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":300000,"minimum":0,"default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/audit":{"get":{"tags":["organizations","organizations"],"summary":"List Organization Audit","description":"Return a backend-generated organization activity feed.","operationId":"list_organization_audit_api_v1_organizations__org_id__audit_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":300000,"minimum":0,"default":0,"title":"Offset"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/workspace-access/sync":{"post":{"tags":["organizations","organizations"],"summary":"Sync Organization Workspace Access","description":"Reconcile project-backed workspace visibility from backend org membership.","operationId":"sync_organization_workspace_access_api_v1_organizations__org_id__workspace_access_sync_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationWorkspaceAccessSyncRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/members":{"get":{"tags":["organizations","organizations"],"summary":"List Organization Members","description":"List organization members and roles.","operationId":"list_organization_members_api_v1_organizations__org_id__members_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":300000,"minimum":0,"default":0,"title":"Offset"}},{"name":"include_inactive","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Inactive"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["organizations","organizations"],"summary":"Upsert Organization Member","description":"Add or update an org member role/status.","operationId":"upsert_organization_member_api_v1_organizations__org_id__members_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertOrganizationMemberRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/members/{user_id}":{"patch":{"tags":["organizations","organizations"],"summary":"Update Organization Member","description":"Patch one org member role/status.","operationId":"update_organization_member_api_v1_organizations__org_id__members__user_id__patch","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOrganizationMemberRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["organizations","organizations"],"summary":"Delete Organization Member","description":"Remove a user membership from organization.","operationId":"delete_organization_member_api_v1_organizations__org_id__members__user_id__delete","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/invites":{"get":{"tags":["organizations","organizations"],"summary":"List Organization Invites","description":"List invite records for one organization.","operationId":"list_organization_invites_api_v1_organizations__org_id__invites_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":300000,"minimum":0,"default":0,"title":"Offset"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["organizations","organizations"],"summary":"Create Organization Invite","description":"Create or refresh an invite for one email address.","operationId":"create_organization_invite_api_v1_organizations__org_id__invites_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrganizationInviteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/invites/{invite_id}/resend":{"post":{"tags":["organizations","organizations"],"summary":"Resend Organization Invite","description":"Rotate an invite token and extend the invite window.","operationId":"resend_organization_invite_api_v1_organizations__org_id__invites__invite_id__resend_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","title":"Invite Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResendOrganizationInviteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/invites/{invite_id}":{"delete":{"tags":["organizations","organizations"],"summary":"Revoke Organization Invite","description":"Revoke one outstanding invite.","operationId":"revoke_organization_invite_api_v1_organizations__org_id__invites__invite_id__delete","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","title":"Invite Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization-invites/preview":{"post":{"tags":["organizations","organizations"],"summary":"Preview Organization Invite","description":"Resolve invite metadata for one token.","operationId":"preview_organization_invite_api_v1_organization_invites_preview_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInviteTokenRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization-invites/accept":{"post":{"tags":["organizations","organizations"],"summary":"Accept Organization Invite","description":"Accept a pending org invite as the signed-in user.","operationId":"accept_organization_invite_api_v1_organization_invites_accept_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInviteTokenRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/api-keys":{"get":{"tags":["organizations"],"summary":"List Organization Api Keys","operationId":"list_organization_api_keys_api_v1_organizations__org_id__api_keys_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"include_revoked","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Revoked"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["organizations"],"summary":"Create Organization Api Key","operationId":"create_organization_api_key_api_v1_organizations__org_id__api_keys_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrganizationAPIKeyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/api-keys/{key_id}/revoke":{"post":{"tags":["organizations"],"summary":"Revoke Organization Api Key","operationId":"revoke_organization_api_key_api_v1_organizations__org_id__api_keys__key_id__revoke_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/api-keys/{key_id}/rotate":{"post":{"tags":["organizations"],"summary":"Rotate Organization Api Key","operationId":"rotate_organization_api_key_api_v1_organizations__org_id__api_keys__key_id__rotate_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/companies":{"get":{"tags":["organizations"],"summary":"List Organization Companies","operationId":"list_organization_companies_api_v1_organizations__org_id__companies_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":300000,"minimum":0,"default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationCompaniesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/orgs/{slug}/data/{entity}":{"get":{"tags":["orgs"],"summary":"Org Browse","description":"Browse entity data for a project.","operationId":"org_browse_api_v1_orgs__slug__data__entity__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"entity","in":"path","required":true,"schema":{"type":"string","title":"Entity"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":300000,"minimum":0,"default":0,"title":"Offset"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"service","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service"}},{"name":"revision_bound","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Revision Bound"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeEntityPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/export/{entity}":{"get":{"tags":["orgs"],"summary":"Org Export","description":"Export entity data as CSV or JSON for a project.","operationId":"org_export_api_v1_orgs__slug__export__entity__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"entity","in":"path","required":true,"schema":{"type":"string","title":"Entity"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(csv|json)$","default":"json","title":"Format"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"JSON rows or a CSV file, selected by format.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}},"text/csv":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/employees/{employee_id}/summary":{"get":{"tags":["orgs"],"summary":"Org Employee Summary","description":"Aggregate payroll, tasks, and deals for a single employee.","operationId":"org_employee_summary_api_v1_orgs__slug__employees__employee_id__summary_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"employee_id","in":"path","required":true,"schema":{"type":"string","title":"Employee Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/export-pack/csv":{"get":{"tags":["orgs"],"summary":"Org Export Generic Csv Pack","description":"Export all canonical ledgers as a documented CSV ZIP bundle.","operationId":"org_export_generic_csv_pack_api_v1_orgs__slug__export_pack_csv_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/export-pack/qbo":{"get":{"tags":["orgs"],"summary":"Org Export Qbo Pack","description":"Export a connector-native QuickBooks workbook bundle for a project.","operationId":"org_export_qbo_pack_api_v1_orgs__slug__export_pack_qbo_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/export-pack/qbo/schema":{"get":{"tags":["orgs"],"summary":"Org Export Qbo Pack Schema","description":"Return the formal QuickBooks workbook schema for the export bundle.","operationId":"org_export_qbo_pack_schema_api_v1_orgs__slug__export_pack_qbo_schema_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/export-pack/hubspot":{"get":{"tags":["orgs"],"summary":"Org Export Hubspot Pack","description":"Export HubSpot-style current-view CSV bundle for a project.","operationId":"org_export_hubspot_pack_api_v1_orgs__slug__export_pack_hubspot_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/export-pack/hubspot/schema":{"get":{"tags":["orgs"],"summary":"Org Export Hubspot Pack Schema","description":"Return the formal HubSpot CSV export-pack schema contract.","operationId":"org_export_hubspot_pack_schema_api_v1_orgs__slug__export_pack_hubspot_schema_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/export-pack/asana":{"get":{"tags":["orgs"],"summary":"Org Export Asana Pack","description":"Export Asana-style per-project CSV bundle for a project.","operationId":"org_export_asana_pack_api_v1_orgs__slug__export_pack_asana_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/export-pack/asana/schema":{"get":{"tags":["orgs"],"summary":"Org Export Asana Pack Schema","description":"Return the formal Asana CSV export-pack schema contract.","operationId":"org_export_asana_pack_schema_api_v1_orgs__slug__export_pack_asana_schema_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/export-pack/{target}":{"get":{"tags":["orgs"],"summary":"Org Export Captured Vendor Pack","description":"Export captured vendor-style CSV bundle for a supported manual target.","operationId":"org_export_captured_vendor_pack_api_v1_orgs__slug__export_pack__target__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/export-pack/{target}/schema":{"get":{"tags":["orgs"],"summary":"Org Export Captured Vendor Pack Schema","description":"Return captured vendor CSV export-pack schema contract.","operationId":"org_export_captured_vendor_pack_schema_api_v1_orgs__slug__export_pack__target__schema_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/info":{"get":{"tags":["orgs"],"summary":"Org Info","description":"Project metadata, record counts, and company profile.","operationId":"org_info_api_v1_orgs__slug__info_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectRuntimeInfo"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/capabilities":{"get":{"tags":["orgs"],"summary":"Org Capabilities","description":"List capabilities with full schemas.","operationId":"org_capabilities_api_v1_orgs__slug__capabilities_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"service","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Service"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RuntimeCapabilities"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/execute":{"post":{"tags":["orgs"],"summary":"Org Execute","description":"Execute a capability scoped to this project.","operationId":"org_execute_api_v1_orgs__slug__execute_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-session-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"X-Session-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolExecutionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ToolExecutionResponse"},{"$ref":"#/components/schemas/ErrorResponse"}],"title":"Response Org Execute Api V1 Orgs  Slug  Execute Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/browser-tokens":{"post":{"tags":["native"],"summary":"Create Native Browser Token","operationId":"create_native_browser_token_api_v1_orgs__slug__browser_tokens_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"origin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Origin"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NativeBrowserTokenRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]}]}},"/api/v1/orgs/{slug}/native/{service}/{path}":{"delete":{"tags":["native"],"summary":"Native Endpoint","description":"Catch-all native endpoint dispatcher.\n\nRoutes to the correct service adapter based on {service}.\nThe adapter handles path parsing and response shaping.","operationId":"native_endpoint_delete","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"service","in":"path","required":true,"schema":{"type":"string","title":"Service"}},{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NativeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]},{"NativeBrowserBearer":[]}]},"put":{"tags":["native"],"summary":"Native Endpoint","description":"Catch-all native endpoint dispatcher.\n\nRoutes to the correct service adapter based on {service}.\nThe adapter handles path parsing and response shaping.","operationId":"native_endpoint_put","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"service","in":"path","required":true,"schema":{"type":"string","title":"Service"}},{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NativeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]},{"NativeBrowserBearer":[]}]},"patch":{"tags":["native"],"summary":"Native Endpoint","description":"Catch-all native endpoint dispatcher.\n\nRoutes to the correct service adapter based on {service}.\nThe adapter handles path parsing and response shaping.","operationId":"native_endpoint_patch","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"service","in":"path","required":true,"schema":{"type":"string","title":"Service"}},{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NativeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]},{"NativeBrowserBearer":[]}]},"post":{"tags":["native"],"summary":"Native Endpoint","description":"Catch-all native endpoint dispatcher.\n\nRoutes to the correct service adapter based on {service}.\nThe adapter handles path parsing and response shaping.","operationId":"native_endpoint_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"service","in":"path","required":true,"schema":{"type":"string","title":"Service"}},{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NativeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]},{"NativeBrowserBearer":[]}]},"get":{"tags":["native"],"summary":"Native Endpoint","description":"Catch-all native endpoint dispatcher.\n\nRoutes to the correct service adapter based on {service}.\nThe adapter handles path parsing and response shaping.","operationId":"native_endpoint_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"service","in":"path","required":true,"schema":{"type":"string","title":"Service"}},{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NativeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]},{"NativeBrowserBearer":[]}]}},"/api/v1/native/services":{"get":{"tags":["native"],"summary":"List Native Services","description":"Return capability maturity matrix for all native services.","operationId":"list_native_services_api_v1_native_services_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/native/services/{service}":{"get":{"tags":["native"],"summary":"Get Native Service Meta","description":"Return capability maturity for a single native service.","operationId":"get_native_service_meta_api_v1_native_services__service__get","parameters":[{"name":"service","in":"path","required":true,"schema":{"type":"string","title":"Service"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/apollo/search":{"post":{"tags":["apollo","apollo"],"summary":"Search Companies","description":"Search for companies using Apollo.io.","operationId":"search_companies_api_v1_apollo_search_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApolloSearchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/apollo/organization/{org_id}":{"get":{"tags":["apollo","apollo"],"summary":"Get Organization","description":"Get full organization profile from Apollo.","operationId":"get_organization_api_v1_apollo_organization__org_id__get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/apollo/enrich":{"post":{"tags":["apollo","apollo"],"summary":"Enrich Company From Domain","description":"Enrich one company from its website domain for onboarding prefills.","operationId":"enrich_company_from_domain_api_v1_apollo_enrich_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApolloDomainEnrichRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/apollo/enrich/stream":{"post":{"tags":["apollo","apollo"],"summary":"Enrich Company From Domain Stream","description":"Stream domain enrichment stages and finish with the enrichment payload.","operationId":"enrich_company_from_domain_stream_api_v1_apollo_enrich_stream_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApolloDomainEnrichRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/apollo/organization/{org_id}/model":{"get":{"tags":["apollo","apollo"],"summary":"Get Organization Model","description":"Get DataModel based on Apollo organization profile.","operationId":"get_organization_model_api_v1_apollo_organization__org_id__model_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"months","in":"query","required":false,"schema":{"type":"integer","default":36,"title":"Months"}},{"name":"quality","in":"query","required":false,"schema":{"type":"string","default":"clean","title":"Quality"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/apollo/organization/{org_id}/dna":{"get":{"tags":["apollo","apollo"],"summary":"Get Organization Dna","description":"Get CompanyDNA based on Apollo organization profile.\n\nReturns the full inference chain: identity, financial shape,\ncustomer profile, vendor stack, org ratios.","operationId":"get_organization_dna_api_v1_apollo_organization__org_id__dna_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"months","in":"query","required":false,"schema":{"type":"integer","default":24,"title":"Months"}},{"name":"quality","in":"query","required":false,"schema":{"type":"string","default":"clean","title":"Quality"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/scenarios":{"get":{"tags":["reference","reference"],"summary":"List Scenarios","description":"List available generation scenarios.","operationId":"list_scenarios_api_v1_scenarios_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/defects":{"get":{"tags":["reference","reference"],"summary":"List Defects","description":"List available defect types for injection.","operationId":"list_defects_api_v1_defects_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/presets":{"get":{"tags":["reference","reference"],"summary":"List Presets","description":"List available data quality presets.","operationId":"list_presets_api_v1_presets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/archetypes":{"get":{"tags":["reference","reference"],"summary":"List Archetypes","description":"List available business archetypes and their parameters.","operationId":"list_archetypes_api_v1_archetypes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/targets":{"get":{"tags":["reference","reference"],"summary":"List Targets","description":"List available targets.","operationId":"list_targets_api_v1_targets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/targets/{name}/health":{"get":{"tags":["reference","reference"],"summary":"Check Target Health","description":"Check if target is reachable.","operationId":"check_target_health_api_v1_targets__name__health_get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sources":{"get":{"tags":["reference","reference"],"summary":"List Sources","description":"List available sources.","operationId":"list_sources_api_v1_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/sources/upload":{"post":{"tags":["reference","reference"],"summary":"Upload File","description":"Upload a file for parsing without retaining uploaded contents.","operationId":"upload_file_api_v1_sources_upload_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/jobs":{"get":{"tags":["reference","reference"],"summary":"List Jobs","description":"List all jobs with optional filtering.","operationId":"list_jobs_api_v1_jobs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":50,"title":"Limit"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/jobs/{job_id}":{"get":{"tags":["reference","reference"],"summary":"Get Job","description":"Get detailed job information.","operationId":"get_job_api_v1_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pipelines":{"get":{"tags":["reference","reference"],"summary":"List Pipelines","description":"List available pipelines.","operationId":"list_pipelines_api_v1_pipelines_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/pipelines/run":{"post":{"tags":["reference","reference"],"summary":"Run Pipeline","description":"Run a pipeline (async).","operationId":"run_pipeline_api_v1_pipelines_run_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pipelines/status/{job_id}":{"get":{"tags":["reference","reference"],"summary":"Get Pipeline Status","description":"Get pipeline job status.","operationId":"get_pipeline_status_api_v1_pipelines_status__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mocks":{"get":{"tags":["mocks"],"summary":"List Mocks","description":"List all registered mock APIs.","operationId":"list_mocks_mocks_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mocks/health":{"get":{"tags":["mocks"],"summary":"Check All Health","description":"Check health of all mock APIs.","operationId":"check_all_health_mocks_health_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mocks/status":{"get":{"tags":["mocks"],"summary":"Get All Status","description":"Get status of all mock APIs including record counts.","operationId":"get_all_status_mocks_status_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mocks/reset-all":{"post":{"tags":["mocks"],"summary":"Reset All Mocks","description":"Reset all mock APIs.\n\nRequires confirm=\"RESET_ALL\" for safety.","operationId":"reset_all_mocks_mocks_reset_all_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mocks/{target}/health":{"get":{"tags":["mocks"],"summary":"Check Mock Health","description":"Check health of a specific mock API.","operationId":"check_mock_health_mocks__target__health_get","parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mocks/{target}/status":{"get":{"tags":["mocks"],"summary":"Get Mock Status","description":"Get detailed status of a specific mock API.","operationId":"get_mock_status_mocks__target__status_get","parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mocks/{target}/reset":{"post":{"tags":["mocks"],"summary":"Reset Mock","description":"Reset a specific mock API.\n\nRequires confirm=\"RESET\" for safety.","operationId":"reset_mock_mocks__target__reset_post","parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mocks/{target}/snapshots":{"get":{"tags":["mocks"],"summary":"List Mock Snapshots","description":"List snapshots for a specific mock API.","operationId":"list_mock_snapshots_mocks__target__snapshots_get","parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mocks/{target}/snapshot":{"post":{"tags":["mocks"],"summary":"Create Mock Snapshot","description":"Create a snapshot for a specific mock API.","operationId":"create_mock_snapshot_mocks__target__snapshot_post","parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mocks/{target}/restore/{snapshot_name}":{"post":{"tags":["mocks"],"summary":"Restore Mock Snapshot","description":"Restore a specific mock API from a snapshot.","operationId":"restore_mock_snapshot_mocks__target__restore__snapshot_name__post","parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}},{"name":"snapshot_name","in":"path","required":true,"schema":{"type":"string","title":"Snapshot Name"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mocks/{target}/snapshot/{snapshot_name}":{"delete":{"tags":["mocks"],"summary":"Delete Mock Snapshot","description":"Delete a snapshot from a specific mock API.","operationId":"delete_mock_snapshot_mocks__target__snapshot__snapshot_name__delete","parameters":[{"name":"target","in":"path","required":true,"schema":{"type":"string","title":"Target"}},{"name":"snapshot_name","in":"path","required":true,"schema":{"type":"string","title":"Snapshot Name"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/orgs/{slug}/simulation/start":{"post":{"tags":["simulation"],"summary":"Simulation Start","description":"Initialize or return existing simulation state.","operationId":"simulation_start_api_v1_orgs__slug__simulation_start_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/simulation/advance":{"post":{"tags":["simulation"],"summary":"Simulation Advance","description":"Advance simulation clock by a time delta.","operationId":"simulation_advance_api_v1_orgs__slug__simulation_advance_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvanceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/simulation/step":{"post":{"tags":["simulation"],"summary":"Simulation Step","description":"Advance simulation by exactly N events.","operationId":"simulation_step_api_v1_orgs__slug__simulation_step_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StepRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/simulation/pause":{"post":{"tags":["simulation"],"summary":"Simulation Pause","description":"Pause the simulation clock.","operationId":"simulation_pause_api_v1_orgs__slug__simulation_pause_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/simulation/resume":{"post":{"tags":["simulation"],"summary":"Simulation Resume","description":"Resume the simulation clock.","operationId":"simulation_resume_api_v1_orgs__slug__simulation_resume_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/simulation/status":{"get":{"tags":["simulation"],"summary":"Simulation Status","description":"Return current simulation state.","operationId":"simulation_status_api_v1_orgs__slug__simulation_status_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/simulation/dials":{"patch":{"tags":["simulation"],"summary":"Simulation Dials","description":"Update dial configuration.","operationId":"simulation_dials_api_v1_orgs__slug__simulation_dials_patch","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DialsPatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/simulation/checkpoint":{"post":{"tags":["simulation"],"summary":"Simulation Checkpoint","description":"Create a checkpoint of current simulation state.","operationId":"simulation_checkpoint_api_v1_orgs__slug__simulation_checkpoint_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckpointRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/simulation/restore/{checkpoint_id}":{"post":{"tags":["simulation"],"summary":"Simulation Restore","description":"Restore simulation to a previous checkpoint.","operationId":"simulation_restore_api_v1_orgs__slug__simulation_restore__checkpoint_id__post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"checkpoint_id","in":"path","required":true,"schema":{"type":"string","title":"Checkpoint Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"x-confirm-destructive","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Confirm-Destructive"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/simulation/checkpoints":{"get":{"tags":["simulation"],"summary":"Simulation Checkpoints","description":"List all checkpoints for this company.","operationId":"simulation_checkpoints_api_v1_orgs__slug__simulation_checkpoints_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/events":{"get":{"tags":["events"],"summary":"List Events","description":"Paginated event feed for a company.","operationId":"list_events_api_v1_orgs__slug__events_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"follow","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Follow"}},{"name":"follow_cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Follow Cursor"}},{"name":"order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"asc","title":"Order"}},{"name":"event_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type"}},{"name":"entity_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"}},{"name":"entity_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Id"}},{"name":"correlation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Correlation Id"}},{"name":"after","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"After"}},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Before"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/events/{event_id}":{"get":{"tags":["events"],"summary":"Get Event","description":"Single event detail with causal chain.","operationId":"get_event_api_v1_orgs__slug__events__event_id__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"event_id","in":"path","required":true,"schema":{"type":"string","title":"Event Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Event"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/scenarios":{"get":{"tags":["scenarios"],"summary":"List Scenario Library","description":"Return the built-in scenario template library.","operationId":"list_scenario_library_api_v1_orgs__slug__scenarios_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/simulation/scenarios":{"post":{"tags":["scenarios"],"summary":"Inject Scenarios","description":"Inject scenarios into a running simulation.","operationId":"inject_scenarios_api_v1_orgs__slug__simulation_scenarios_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InjectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/simulation/manifest":{"get":{"tags":["scenarios"],"summary":"Get Manifest","description":"Return the current ground truth manifest.","operationId":"get_manifest_api_v1_orgs__slug__simulation_manifest_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/simulation/configurations":{"get":{"tags":["scenarios"],"summary":"Get Scenario Configurations","description":"Return persisted customer-selected scenario terms without ground truth.","operationId":"get_scenario_configurations_api_v1_orgs__slug__simulation_configurations_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScenarioConfigurationsV2Response"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/simulation/scenarios/{scenario_id}":{"delete":{"tags":["scenarios"],"summary":"Deactivate Scenario","description":"Soft-remove a scenario. Needles remain in dataset.","operationId":"deactivate_scenario_api_v1_orgs__slug__simulation_scenarios__scenario_id__delete","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"scenario_id","in":"path","required":true,"schema":{"type":"string","title":"Scenario Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/scenarios/generate":{"post":{"tags":["scenarios"],"summary":"Generate Scenario","description":"Match a plain-text description to a scenario template (keyword MVP).\n\nReturns a scenario config dict ready for injection via POST\n/{slug}/simulation/scenarios.","operationId":"generate_scenario_api_v1_orgs__slug__scenarios_generate_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScenarioGenerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/test-matrices":{"post":{"tags":["test-matrices"],"summary":"Create Matrix","description":"Create a new test matrix.","operationId":"create_matrix_api_v1_orgs__slug__test_matrices_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMatrixRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]},"get":{"tags":["test-matrices"],"summary":"List Matrices","description":"List all test matrices for this organization.","operationId":"list_matrices_api_v1_orgs__slug__test_matrices_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/test-matrices/{matrix_id}":{"get":{"tags":["test-matrices"],"summary":"Get Matrix","description":"Get test matrix details with latest run and history.","operationId":"get_matrix_api_v1_orgs__slug__test_matrices__matrix_id__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"matrix_id","in":"path","required":true,"schema":{"type":"string","title":"Matrix Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]},"delete":{"tags":["test-matrices"],"summary":"Delete Matrix","description":"Delete a test matrix.","operationId":"delete_matrix_api_v1_orgs__slug__test_matrices__matrix_id__delete","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"matrix_id","in":"path","required":true,"schema":{"type":"string","title":"Matrix Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/test-runs":{"post":{"tags":["test-matrices"],"summary":"Submit Test Run","description":"Submit detection results and compute metrics.","operationId":"submit_test_run_api_v1_orgs__slug__test_runs_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitTestRunRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]},"get":{"tags":["test-matrices"],"summary":"List Test Runs","description":"List test runs for a matrix.","operationId":"list_test_runs_api_v1_orgs__slug__test_runs_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"matrix_id","in":"query","required":true,"schema":{"type":"string","title":"Matrix Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/test-runs/{run_id}":{"get":{"tags":["test-matrices"],"summary":"Get Test Run","description":"Get a single test run by ID.","operationId":"get_test_run_api_v1_orgs__slug__test_runs__run_id__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/personas":{"get":{"tags":["personas"],"summary":"List Personas","description":"List available persona roles.","operationId":"list_personas_api_v1_orgs__slug__personas_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/personas/{role}/chat":{"post":{"tags":["personas"],"summary":"Persona Chat","description":"Chat with a persona role, grounded in company data.","operationId":"persona_chat_api_v1_orgs__slug__personas__role__chat_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"role","in":"path","required":true,"schema":{"type":"string","title":"Role"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/personas/{role}/action":{"post":{"tags":["personas"],"summary":"Persona Action","description":"Execute an action as a persona role.","operationId":"persona_action_api_v1_orgs__slug__personas__role__action_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"role","in":"path","required":true,"schema":{"type":"string","title":"Role"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/personas/{role}/history":{"get":{"tags":["personas"],"summary":"Persona History","description":"Retrieve conversation history for a persona session.","operationId":"persona_history_api_v1_orgs__slug__personas__role__history_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"role","in":"path","required":true,"schema":{"type":"string","title":"Role"}},{"name":"session_id","in":"query","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/billing/catalog":{"get":{"tags":["billing","billing"],"summary":"Get Billing Catalog","description":"Return public pricing catalog for frontend upgrade paths.","operationId":"get_billing_catalog_api_v1_billing_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/organizations/{org_id}/billing":{"get":{"tags":["billing","billing"],"summary":"Get Organization Billing Summary","description":"Return backend-authoritative billing summary for one organization.","operationId":"get_organization_billing_summary_api_v1_organizations__org_id__billing_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/billing/checkout-session":{"post":{"tags":["billing","billing"],"summary":"Create Checkout Session","description":"Create a hosted Stripe Checkout Session for one organization.","operationId":"create_checkout_session_api_v1_organizations__org_id__billing_checkout_session_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutSessionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/billing/portal-session":{"post":{"tags":["billing","billing"],"summary":"Create Portal Session","description":"Create a Stripe Customer Portal session for one organization.","operationId":"create_portal_session_api_v1_organizations__org_id__billing_portal_session_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortalSessionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/billing/sync":{"post":{"tags":["billing","billing"],"summary":"Sync Organization Billing","description":"Force one reconciliation pass after Checkout redirects or webhook delay.","operationId":"sync_organization_billing_api_v1_organizations__org_id__billing_sync_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingSyncRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stripe/webhook":{"post":{"tags":["billing","billing"],"summary":"Receive Stripe Webhook","description":"Receive snapshot billing webhooks from the primary Stripe destination.","operationId":"receive_stripe_webhook_api_v1_stripe_webhook_post","parameters":[{"name":"Stripe-Signature","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stripe/metering-webhook":{"post":{"tags":["billing","billing"],"summary":"Receive Stripe Metering Webhook","description":"Receive Stripe thin Meter Event validation errors on a separate secret.","operationId":"receive_stripe_metering_webhook_api_v1_stripe_metering_webhook_post","parameters":[{"name":"Stripe-Signature","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/pricing/rules":{"get":{"tags":["credits","pricing"],"summary":"Get Active Pricing Rules","description":"Return active hot-reloaded pricing rules.","operationId":"get_active_pricing_rules_api_v1_pricing_rules_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/organizations/{org_id}/credits":{"get":{"tags":["credits","credits"],"summary":"Get Organization Credits","description":"Return the authoritative organization balance for all workspaces.","operationId":"get_organization_credits_api_v1_organizations__org_id__credits_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/credits/ledger":{"get":{"tags":["credits","credits"],"summary":"List Organization Credit Ledger","description":"List one org ledger with optional attribution filters.","operationId":"list_organization_credit_ledger_api_v1_organizations__org_id__credits_ledger_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Before"}},{"name":"workspaceId","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workspaceid"}},{"name":"projectId","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Projectid"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/credit-runs":{"post":{"tags":["credits","runs"],"summary":"Submit Organization Run","description":"Charge and reserve one first-run or regeneration against an org.","operationId":"submit_organization_run_api_v1_organizations__org_id__credit_runs_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationRunSubmissionRequestModel"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/credit-runs/{run_id}/regenerate":{"post":{"tags":["credits","runs"],"summary":"Regenerate Organization Credit Run","description":"Create a paid regeneration reservation inside one organization.","operationId":"regenerate_organization_credit_run_api_v1_organizations__org_id__credit_runs__run_id__regenerate_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegenerateRequestModel"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/credit-runs/{run_id}/restore":{"post":{"tags":["credits","runs"],"summary":"Restore Organization Credit Run","description":"Return restore metadata for an organization-owned credit run.","operationId":"restore_organization_credit_run_api_v1_organizations__org_id__credit_runs__run_id__restore_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/credit-runs/{run_id}/events":{"get":{"tags":["credits","runs"],"summary":"Stream Organization Credit Run Events","description":"Stream the current event snapshot for an organization-owned run.","operationId":"stream_organization_credit_run_events_api_v1_organizations__org_id__credit_runs__run_id__events_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/credit-runs/{run_id}/progress":{"get":{"tags":["credits","runs"],"summary":"Stream Organization Credit Run Progress","description":"Stream progress for an organization-owned run.","operationId":"stream_organization_credit_run_progress_api_v1_organizations__org_id__credit_runs__run_id__progress_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organizations/{org_id}/credits/topup-checkout":{"post":{"tags":["credits","credits"],"summary":"Create Organization Credit Topup Checkout","description":"Create a Stripe Checkout session that credits a purchased org bucket.","operationId":"create_organization_credit_topup_checkout_api_v1_organizations__org_id__credits_topup_checkout_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationCreditTopUpRequestModel"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/credits":{"get":{"tags":["credits","credits"],"summary":"Get Workspace Credits","operationId":"get_workspace_credits_api_v1_workspaces__workspace_id__credits_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/credits/ledger":{"get":{"tags":["credits","credits"],"summary":"List Workspace Credit Ledger","operationId":"list_workspace_credit_ledger_api_v1_workspaces__workspace_id__credits_ledger_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Before"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/runs":{"post":{"tags":["credits","runs"],"summary":"Submit Run","operationId":"submit_run_api_v1_runs_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunSubmissionRequestModel"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/runs/{run_id}/regenerate":{"post":{"tags":["credits","runs"],"summary":"Regenerate Run","operationId":"regenerate_run_api_v1_runs__run_id__regenerate_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegenerateRequestModel"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/runs/{run_id}/restore":{"post":{"tags":["credits","runs"],"summary":"Restore Run","operationId":"restore_run_api_v1_runs__run_id__restore_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/runs/{run_id}/events":{"get":{"tags":["credits","runs"],"summary":"Stream Run Events","operationId":"stream_run_events_api_v1_runs__run_id__events_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/runs/{run_id}/progress":{"get":{"tags":["credits","runs"],"summary":"Stream Run Progress","operationId":"stream_run_progress_api_v1_runs__run_id__progress_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/credits/topup":{"post":{"tags":["credits","credits"],"summary":"Create Credit Topup Checkout","operationId":"create_credit_topup_checkout_api_v1_credits_topup_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditTopUpRequestModel"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/orgs/{slug}/audit/events":{"get":{"tags":["audit"],"summary":"Audit Events","description":"Export usage events or authenticated append-only project audit events.","operationId":"audit_events_api_v1_orgs__slug__audit_events_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"After"}},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Before"}},{"name":"event_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type"}},{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"usage","title":"Source"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/audit/usage":{"get":{"tags":["audit"],"summary":"Audit Usage","description":"Current-period usage meters for an org.","operationId":"audit_usage_api_v1_orgs__slug__audit_usage_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"period","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/audit/api-keys":{"get":{"tags":["audit"],"summary":"Audit Api Keys","description":"List all API keys (active + revoked) for audit purposes.","operationId":"audit_api_keys_api_v1_orgs__slug__audit_api_keys_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/webhooks":{"post":{"tags":["webhooks"],"summary":"Create Webhook","description":"Register a new webhook subscription for an org.","operationId":"create_webhook_api_v1_orgs__slug__webhooks_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscription"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]}]},"get":{"tags":["webhooks"],"summary":"List Webhooks","description":"List all webhook subscriptions for an org.","operationId":"list_webhooks_api_v1_orgs__slug__webhooks_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"ProjectApiKey":[]},{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/webhooks/{webhook_id}":{"delete":{"tags":["webhooks"],"summary":"Delete Webhook","description":"Delete a webhook subscription.","operationId":"delete_webhook_api_v1_orgs__slug__webhooks__webhook_id__delete","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","title":"Webhook Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletedResource"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]}]}},"/api/v1/orgs/{slug}/webhooks/{webhook_id}/test":{"post":{"tags":["webhooks"],"summary":"Test Webhook","description":"Send a test event to a specific webhook subscription.","operationId":"test_webhook_api_v1_orgs__slug__webhooks__webhook_id__test_post","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","title":"Webhook Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTestRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDeliveryQueued"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"Missing, expired, or invalid authentication.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"403":{"description":"Authenticated caller is not entitled or authorized.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"429":{"description":"Rate or plan quota limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"500":{"description":"Unexpected server failure. Capture the request_id for support.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}},"503":{"description":"Service or deployment is not ready. Retry with backoff.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerError"}}}}},"security":[{"BearerAuth":[]}]}},"/api/v1/workspaces":{"get":{"tags":["workspaces"],"summary":"List Workspaces","description":"List project-backed workspaces visible to the signed-in user.","operationId":"list_workspaces_api_v1_workspaces_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":300000,"minimum":0,"default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}":{"get":{"tags":["workspaces"],"summary":"Get Workspace","description":"Fetch one project-backed workspace.","operationId":"get_workspace_api_v1_workspaces__workspace_id__get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/{workspace_id}/usage":{"get":{"tags":["workspaces"],"summary":"Get Workspace Usage","description":"Return persisted test-run usage for a project-backed workspace.","operationId":"get_workspace_usage_api_v1_workspaces__workspace_id__usage_get","parameters":[{"name":"workspace_id","in":"path","required":true,"schema":{"type":"string","title":"Workspace Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/workspaces/snapshot":{"post":{"tags":["workspaces"],"summary":"Upsert Workspace Snapshot","description":"Record project/workspace linkage in backend-owned stores.","operationId":"upsert_workspace_snapshot_api_v1_workspaces_snapshot_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"X-Admin-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceSnapshotRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/":{"get":{"tags":["root"],"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"tags":["root"],"summary":"Health","description":"Process liveness for platform healthchecks.\n\n`/ready` remains the fail-closed release gate. This endpoint stays available\nfor platform rollout while reporting fresh readiness diagnostics. Never use\nthe traffic cache here: it can report stale success after checks start\nfailing. This synchronous route runs its checks in the request threadpool.","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/ready":{"get":{"tags":["root"],"summary":"Ready","description":"Readiness gate for deploys and production monitors.\n\nLiveness can stay healthy while required production hardening is missing.\nReadiness fails closed so staging/prod rollouts can stop before traffic.\n\nBuilt inline on purpose: it is the authority a rollout consults before taking\ntraffic, and a cached answer could vouch for a deployment using state\ngathered before the dependency it exists to catch broke.","operationId":"ready_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/config":{"get":{"tags":["root"],"summary":"Get Configuration","description":"Get current configuration.","operationId":"get_configuration_api_v1_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ActionRequest":{"properties":{"action_type":{"type":"string","title":"Action Type"},"target_entity":{"type":"string","title":"Target Entity"},"params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Params"}},"type":"object","required":["action_type","target_entity"],"title":"ActionRequest","description":"Action request for a persona to execute."},"AdvanceRequest":{"properties":{"days":{"type":"integer","minimum":0.0,"title":"Days","default":0},"hours":{"type":"integer","minimum":0.0,"title":"Hours","default":0},"minutes":{"type":"integer","minimum":0.0,"title":"Minutes","default":0}},"type":"object","title":"AdvanceRequest"},"ApolloDomainEnrichRequest":{"properties":{"domain":{"type":"string","title":"Domain"}},"type":"object","required":["domain"],"title":"ApolloDomainEnrichRequest","description":"Request model for domain-first Apollo enrichment."},"ApolloSearchRequest":{"properties":{"query":{"type":"string","title":"Query"},"limit":{"type":"integer","title":"Limit","default":10}},"type":"object","required":["query"],"title":"ApolloSearchRequest"},"BillingSyncRequest":{"properties":{"checkout_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checkout Session Id"}},"type":"object","title":"BillingSyncRequest"},"BootstrapGenerationRequest":{"properties":{"employees":{"type":"integer","title":"Employees","default":12},"months_of_history":{"type":"integer","title":"Months Of History","default":24},"months":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Months"},"reference_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Reference Date"},"segment_mix":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Segment Mix"},"seasonal_pattern":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Seasonal Pattern"},"growth_pattern":{"type":"string","title":"Growth Pattern","default":"steady"},"acquisition_start_weight":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Acquisition Start Weight"},"geo_distribution":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Geo Distribution"},"customers_per_employee":{"type":"number","title":"Customers Per Employee","default":5.0},"payment_rate":{"type":"number","title":"Payment Rate","default":0.9},"quality_preset":{"type":"string","title":"Quality Preset","default":"realistic"},"archetype":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archetype"},"vendors":{"anyOf":[{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array"},{"type":"null"}],"title":"Vendors"},"connectors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Connectors"},"seed":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Seed"},"seedSplit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seedsplit"},"targetTransactionVolume":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":1.0},{"type":"null"}],"title":"Targettransactionvolume"},"charge_on_create":{"type":"boolean","title":"Charge On Create","default":false},"anomalyInjection":{"type":"boolean","title":"Anomalyinjection","default":false},"nativeExportFormats":{"items":{"type":"string"},"type":"array","title":"Nativeexportformats"},"scenario":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scenario"},"realism":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Realism"},"perPlatformRealism":{"additionalProperties":{"type":"string"},"type":"object","title":"Perplatformrealism"},"volumeMultipliers":{"additionalProperties":{"type":"number"},"type":"object","title":"Volumemultipliers"},"needles":{"additionalProperties":{"type":"integer"},"type":"object","title":"Needles"},"drift":{"additionalProperties":{"type":"integer"},"type":"object","title":"Drift"},"coherenceOn":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Coherenceon"},"periodMode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Periodmode"},"asOfDate":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Asofdate"},"durationMonths":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Durationmonths"},"periodFY":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Periodfy"},"periodFYEnd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Periodfyend"},"periodQuarter":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Periodquarter"},"periodCustomStart":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Periodcustomstart"},"periodCustomEnd":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Periodcustomend"}},"type":"object","title":"BootstrapGenerationRequest","description":"Generation settings for one-call project bootstrap."},"BootstrapProjectRequest":{"properties":{"name":{"type":"string","title":"Name"},"org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Id"},"email_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Domain"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"apollo_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apollo Id"},"data_mode":{"anyOf":[{"type":"string","enum":["replica","synthetic"]},{"type":"null"}],"title":"Data Mode"},"archetype":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archetype"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"employee_count":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":1.0},{"type":"null"}],"title":"Employee Count"},"annual_revenue":{"anyOf":[{"type":"integer","maximum":10000000000000.0,"minimum":1.0},{"type":"null"}],"title":"Annual Revenue"},"customer_accounts":{"anyOf":[{"type":"integer","maximum":1000000000.0,"minimum":1.0},{"type":"null"}],"title":"Customer Accounts"},"company_age_months":{"anyOf":[{"type":"integer","maximum":1200.0,"minimum":0.0},{"type":"null"}],"title":"Company Age Months"},"selected_services":{"items":{"type":"string"},"type":"array","title":"Selected Services"},"dials":{"additionalProperties":{"type":"number"},"type":"object","title":"Dials"},"seedSplit":{"type":"string","title":"Seedsplit","default":"demo"},"generation":{"$ref":"#/components/schemas/BootstrapGenerationRequest"},"simulation":{"$ref":"#/components/schemas/BootstrapSimulationRequest"},"scenarios":{"items":{"$ref":"#/components/schemas/BootstrapScenarioRequest"},"type":"array","title":"Scenarios"},"publish":{"type":"boolean","title":"Publish","default":true},"charge_on_create":{"type":"boolean","title":"Charge On Create","default":false}},"type":"object","required":["name"],"title":"BootstrapProjectRequest","description":"One-call PM workflow: create + generate + start + scenario + publish."},"BootstrapScenarioRequest":{"properties":{"id":{"type":"string","title":"Id"},"params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Params"}},"type":"object","required":["id"],"title":"BootstrapScenarioRequest","description":"Scenario injection payload for one-call project bootstrap."},"BootstrapSimulationRequest":{"properties":{"seed":{"type":"integer","maximum":2147483647.0,"minimum":0.0,"title":"Seed","default":42},"dials":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dials"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},"type":"object","title":"BootstrapSimulationRequest","description":"Simulation settings for one-call project bootstrap."},"ChatRequest":{"properties":{"message":{"type":"string","title":"Message"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"}},"type":"object","required":["message"],"title":"ChatRequest","description":"Chat message from user to persona."},"CheckoutSessionRequest":{"properties":{"plan_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Code"},"price_lookup_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Lookup Key"},"success_url":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Success Url"},"cancel_url":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Cancel Url"},"success_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Success Path"},"cancel_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cancel Path"},"allow_promotion_codes":{"type":"boolean","title":"Allow Promotion Codes","default":true},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency Key"}},"type":"object","title":"CheckoutSessionRequest"},"CheckpointRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","title":"CheckpointRequest"},"CompanyBlueprintResolveRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"apollo_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apollo Id"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"employees":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":1.0},{"type":"null"}],"title":"Employees"},"annual_revenue":{"anyOf":[{"type":"integer","maximum":10000000000000.0,"minimum":1.0},{"type":"null"}],"title":"Annual Revenue"},"customer_accounts":{"anyOf":[{"type":"integer","maximum":1000000000.0,"minimum":1.0},{"type":"null"}],"title":"Customer Accounts"},"months_of_history":{"type":"integer","maximum":120.0,"minimum":1.0,"title":"Months Of History","default":24},"quality_preset":{"type":"string","title":"Quality Preset","default":"realistic"},"connectors":{"items":{"type":"string"},"type":"array","title":"Connectors"}},"type":"object","title":"CompanyBlueprintResolveRequest","description":"Resolve a research-grade company blueprint before generation."},"CreateAPIKeyRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"expires_in_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires In Days"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"}},"type":"object","title":"CreateAPIKeyRequest","description":"Request to create a new project API key."},"CreateMatrixRequest":{"properties":{"name":{"type":"string","title":"Name"},"scenarios":{"items":{"$ref":"#/components/schemas/ScenarioSpec"},"type":"array","title":"Scenarios"},"thresholds":{"$ref":"#/components/schemas/ThresholdsBody"}},"type":"object","required":["name"],"title":"CreateMatrixRequest"},"CreateOrganizationAPIKeyRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Name"},"expires_in_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires In Days"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"}},"type":"object","title":"CreateOrganizationAPIKeyRequest"},"CreateOrganizationInviteRequest":{"properties":{"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role","default":"member"},"expires_in_days":{"type":"integer","title":"Expires In Days","default":7}},"type":"object","required":["email"],"title":"CreateOrganizationInviteRequest","description":"Request payload for creating an org invite."},"CreateOrganizationRequest":{"properties":{"name":{"type":"string","title":"Name"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"tier":{"type":"string","title":"Tier","default":"starter"},"meta":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","required":["name"],"title":"CreateOrganizationRequest","description":"Request payload for creating an organization."},"CreateProjectRequest":{"properties":{"name":{"type":"string","title":"Name"},"org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Id"},"email_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Domain"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"apollo_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apollo Id"},"data_mode":{"anyOf":[{"type":"string","enum":["replica","synthetic"]},{"type":"null"}],"title":"Data Mode"},"archetype":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archetype"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"employee_count":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":1.0},{"type":"null"}],"title":"Employee Count"},"annual_revenue":{"anyOf":[{"type":"integer","maximum":10000000000000.0,"minimum":1.0},{"type":"null"}],"title":"Annual Revenue"},"customer_accounts":{"anyOf":[{"type":"integer","maximum":1000000000.0,"minimum":1.0},{"type":"null"}],"title":"Customer Accounts"},"company_age_months":{"anyOf":[{"type":"integer","maximum":1200.0,"minimum":0.0},{"type":"null"}],"title":"Company Age Months"},"selected_services":{"items":{"type":"string"},"type":"array","title":"Selected Services"},"dials":{"additionalProperties":{"type":"number"},"type":"object","title":"Dials"},"seedSplit":{"type":"string","title":"Seedsplit","default":"demo"}},"type":"object","required":["name"],"title":"CreateProjectRequest","description":"Request to create a new project."},"CreditTopUpRequestModel":{"properties":{"workspaceId":{"type":"string","title":"Workspaceid"},"credits":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Credits"},"returnPath":{"type":"string","title":"Returnpath"}},"type":"object","required":["workspaceId","credits","returnPath"],"title":"CreditTopUpRequestModel"},"DemoJobCompanyRequest":{"properties":{"name":{"type":"string","title":"Name"},"org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Id"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"apollo_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apollo Id"},"data_mode":{"anyOf":[{"type":"string","enum":["replica","synthetic"]},{"type":"null"}],"title":"Data Mode"},"archetype":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archetype"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"employee_count":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":1.0},{"type":"null"}],"title":"Employee Count"},"annual_revenue":{"anyOf":[{"type":"integer","maximum":10000000000000.0,"minimum":1.0},{"type":"null"}],"title":"Annual Revenue"},"customer_accounts":{"anyOf":[{"type":"integer","maximum":1000000000.0,"minimum":1.0},{"type":"null"}],"title":"Customer Accounts"},"company_age_months":{"anyOf":[{"type":"integer","maximum":1200.0,"minimum":0.0},{"type":"null"}],"title":"Company Age Months"},"selected_services":{"items":{"type":"string"},"type":"array","title":"Selected Services"},"dials":{"additionalProperties":{"type":"number"},"type":"object","title":"Dials"}},"additionalProperties":false,"type":"object","required":["name"],"title":"DemoJobCompanyRequest"},"DemoJobCompanyResponse":{"properties":{"name":{"type":"string","title":"Name"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"archetype":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archetype"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"business_family":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Family"},"classification":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Classification"},"employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Employee Count"},"annual_revenue":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Annual Revenue"},"customer_accounts":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Customer Accounts"},"company_age_months":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Company Age Months"},"selected_services":{"items":{"type":"string"},"type":"array","title":"Selected Services"},"data_mode":{"anyOf":[{"type":"string","enum":["replica","synthetic"]},{"type":"null"}],"title":"Data Mode"},"fidelity":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Fidelity"},"profile_summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Profile Summary"},"blueprint":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Blueprint"},"company_dna":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Company Dna"},"generation_company_dna":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Generation Company Dna"},"generator_version":{"type":"integer","minimum":1.0,"title":"Generator Version","default":1}},"additionalProperties":false,"type":"object","required":["name","selected_services"],"title":"DemoJobCompanyResponse"},"DemoJobCreateRequest":{"properties":{"company":{"$ref":"#/components/schemas/DemoJobCompanyRequest"},"generation":{"$ref":"#/components/schemas/BootstrapGenerationRequest"},"simulation":{"$ref":"#/components/schemas/BootstrapSimulationRequest"},"scenarios":{"items":{"$ref":"#/components/schemas/BootstrapScenarioRequest"},"type":"array","title":"Scenarios"},"publish":{"type":"boolean","title":"Publish","default":true},"charge_on_create":{"type":"boolean","title":"Charge On Create","default":false}},"additionalProperties":false,"type":"object","required":["company"],"title":"DemoJobCreateRequest"},"DemoJobCreateResponse":{"properties":{"object":{"type":"string","const":"demo_job","title":"Object"},"contract_version":{"type":"string","title":"Contract Version"},"regeneration_required":{"type":"boolean","title":"Regeneration Required"},"id":{"type":"string","title":"Id"},"status":{"type":"string","const":"ready","title":"Status"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"generated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Generated At"},"company":{"$ref":"#/components/schemas/DemoJobCompanyResponse"},"runtime":{"$ref":"#/components/schemas/DemoJobRuntimeResponse"},"links":{"$ref":"#/components/schemas/DemoJobLinkResponse"},"dataset_summary":{"$ref":"#/components/schemas/DemoJobDatasetSummaryResponse"},"quality":{"$ref":"#/components/schemas/DemoJobQualityResponse"},"simulation":{"anyOf":[{"$ref":"#/components/schemas/DemoJobSimulationResponse"},{"type":"null"}]},"scenario_manifest":{"anyOf":[{"$ref":"#/components/schemas/DemoJobScenarioManifestResponse"},{"type":"null"}]},"credentials":{"$ref":"#/components/schemas/DemoJobCredentialResponse"},"credit":{"anyOf":[{"$ref":"#/components/schemas/DemoJobCreditResponse"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["object","contract_version","regeneration_required","id","status","company","runtime","links","dataset_summary","quality","credentials"],"title":"DemoJobCreateResponse","description":"A ready job, settled accounting receipt, and replayable credential."},"DemoJobCredentialResponse":{"properties":{"api_key":{"type":"string","minLength":1,"title":"Api Key"},"api_key_id":{"type":"string","minLength":1,"title":"Api Key Id"},"api_key_prefix":{"type":"string","minLength":1,"title":"Api Key Prefix"}},"additionalProperties":false,"type":"object","required":["api_key","api_key_id","api_key_prefix"],"title":"DemoJobCredentialResponse"},"DemoJobCreditErrorResponse":{"properties":{"error":{"type":"string","title":"Error"},"message":{"type":"string","title":"Message"}},"additionalProperties":true,"type":"object","required":["error","message"],"title":"DemoJobCreditErrorResponse"},"DemoJobCreditResponse":{"properties":{"runId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Runid"},"cost":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Cost"},"charged":{"type":"boolean","title":"Charged"},"billingExempt":{"type":"boolean","title":"Billingexempt"},"replayed":{"type":"boolean","title":"Replayed"}},"additionalProperties":false,"type":"object","required":["charged","billingExempt","replayed"],"title":"DemoJobCreditResponse"},"DemoJobDatasetSummaryResponse":{"properties":{"record_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Record Counts"},"system_record_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"System Record Counts"},"service_coverage":{"items":{"$ref":"#/components/schemas/DemoJobServiceCoverageResponse"},"type":"array","title":"Service Coverage"},"available_entities":{"items":{"type":"string"},"type":"array","title":"Available Entities"},"entities":{"items":{"$ref":"#/components/schemas/DemoJobEntitySummaryResponse"},"type":"array","title":"Entities"},"total_records":{"type":"integer","minimum":0.0,"title":"Total Records"},"materialization":{"$ref":"#/components/schemas/DemoJobMaterializationResponse"}},"additionalProperties":false,"type":"object","required":["record_counts","system_record_counts","service_coverage","available_entities","entities","total_records","materialization"],"title":"DemoJobDatasetSummaryResponse"},"DemoJobDiscoveryReadiness":{"properties":{"can_generate":{"type":"boolean","title":"Can Generate"},"review_required":{"type":"boolean","title":"Review Required"},"stage":{"type":"string","enum":["company_research","connector_fidelity","ready"],"title":"Stage"},"blocking_reasons":{"items":{"type":"string"},"type":"array","title":"Blocking Reasons"},"blocking_details":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Blocking Details"}},"additionalProperties":false,"type":"object","required":["can_generate","review_required","stage"],"title":"DemoJobDiscoveryReadiness","description":"Machine-enforceable gate between discovery and create."},"DemoJobDiscoveryRequest":{"properties":{"prompt":{"type":"string","maxLength":2000,"minLength":1,"title":"Prompt"},"months_of_history":{"anyOf":[{"type":"integer","maximum":120.0,"minimum":1.0},{"type":"null"}],"title":"Months Of History"},"quality_preset":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quality Preset"},"industry":{"anyOf":[{"type":"string","maxLength":120,"minLength":2},{"type":"null"}],"title":"Industry"},"data_mode":{"type":"string","enum":["replica","synthetic"],"title":"Data Mode","default":"replica"}},"additionalProperties":false,"type":"object","required":["prompt"],"title":"DemoJobDiscoveryRequest","description":"Natural-language company discovery request."},"DemoJobDiscoveryResponse":{"properties":{"object":{"type":"string","const":"company_discovery","title":"Object"},"contract_version":{"type":"string","title":"Contract Version"},"status":{"type":"string","enum":["resolved","resolved_unverified","partial","not_found","unavailable","identity_mismatch"],"title":"Status"},"intent":{"additionalProperties":true,"type":"object","title":"Intent"},"company":{"additionalProperties":true,"type":"object","title":"Company"},"identity_candidates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Identity Candidates"},"requested_systems":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Requested Systems"},"observed_systems":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Observed Systems"},"provider_diagnostics":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Provider Diagnostics"},"generation_controls":{"additionalProperties":true,"type":"object","title":"Generation Controls"},"blueprint":{"additionalProperties":true,"type":"object","title":"Blueprint"},"summary":{"additionalProperties":true,"type":"object","title":"Summary"},"generation_readiness":{"$ref":"#/components/schemas/DemoJobDiscoveryReadiness"},"create_request":{"anyOf":[{"$ref":"#/components/schemas/DemoJobCreateRequest"},{"type":"null"}]},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"additionalProperties":false,"type":"object","required":["object","contract_version","status","intent","company","requested_systems","generation_controls","blueprint","summary","generation_readiness","create_request"],"title":"DemoJobDiscoveryResponse","description":"Stable top-level contract for natural-language company discovery."},"DemoJobEntitySummaryResponse":{"properties":{"name":{"type":"string","title":"Name"},"aliases":{"items":{"type":"string"},"type":"array","title":"Aliases"},"description":{"type":"string","title":"Description"},"count":{"type":"integer","minimum":0.0,"title":"Count"},"available":{"type":"boolean","title":"Available"}},"additionalProperties":false,"type":"object","required":["name","aliases","description","count","available"],"title":"DemoJobEntitySummaryResponse"},"DemoJobErrorResponse":{"properties":{"detail":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"}],"title":"Detail"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"}},"additionalProperties":false,"type":"object","required":["detail"],"title":"DemoJobErrorResponse"},"DemoJobFailureClassResponse":{"properties":{"class":{"type":"string","title":"Class"},"count":{"type":"integer","minimum":0.0,"title":"Count"},"critical":{"type":"integer","minimum":0.0,"title":"Critical"},"warning":{"type":"integer","minimum":0.0,"title":"Warning"},"examples":{"items":{"$ref":"#/components/schemas/DemoJobFailureExampleResponse"},"type":"array","title":"Examples"}},"additionalProperties":false,"type":"object","required":["class","count","critical","warning","examples"],"title":"DemoJobFailureClassResponse"},"DemoJobFailureExampleResponse":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"severity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity"}},"additionalProperties":false,"type":"object","title":"DemoJobFailureExampleResponse"},"DemoJobLinkResponse":{"properties":{"self":{"type":"string","title":"Self"},"status":{"type":"string","title":"Status"},"quality":{"type":"string","title":"Quality"},"certificate":{"type":"string","title":"Certificate"},"runtime_readiness":{"type":"string","title":"Runtime Readiness"},"bundle":{"type":"string","title":"Bundle"},"entities":{"type":"string","title":"Entities"},"simulation":{"type":"string","title":"Simulation"},"simulation_start":{"type":"string","title":"Simulation Start"},"simulation_advance":{"type":"string","title":"Simulation Advance"},"scenario_library":{"type":"string","title":"Scenario Library"},"scenario_generate":{"type":"string","title":"Scenario Generate"},"scenario_inject":{"type":"string","title":"Scenario Inject"},"scenario_manifest":{"type":"string","title":"Scenario Manifest"},"events":{"type":"string","title":"Events"},"test_matrices":{"type":"string","title":"Test Matrices"},"test_runs":{"type":"string","title":"Test Runs"},"publish":{"type":"string","title":"Publish"},"clone":{"type":"string","title":"Clone"},"reset":{"type":"string","title":"Reset"}},"additionalProperties":false,"type":"object","required":["self","status","quality","certificate","runtime_readiness","bundle","entities","simulation","simulation_start","simulation_advance","scenario_library","scenario_generate","scenario_inject","scenario_manifest","events","test_matrices","test_runs","publish","clone","reset"],"title":"DemoJobLinkResponse"},"DemoJobMaterializationResponse":{"properties":{"version":{"type":"integer","minimum":0.0,"title":"Version"},"active_systems":{"type":"integer","minimum":0.0,"title":"Active Systems"},"total_records":{"type":"integer","minimum":0.0,"title":"Total Records"},"systems":{"additionalProperties":{"$ref":"#/components/schemas/DemoJobMaterializedSystemResponse"},"type":"object","title":"Systems"}},"additionalProperties":false,"type":"object","required":["version","active_systems","total_records","systems"],"title":"DemoJobMaterializationResponse"},"DemoJobMaterializedSystemResponse":{"properties":{"records_total":{"type":"integer","minimum":0.0,"title":"Records Total"},"populated_record_types":{"type":"integer","minimum":0.0,"title":"Populated Record Types"},"present_value_keys":{"type":"integer","minimum":0.0,"title":"Present Value Keys"},"sources":{"additionalProperties":{"type":"integer"},"type":"object","title":"Sources"}},"additionalProperties":false,"type":"object","required":["records_total","populated_record_types","present_value_keys","sources"],"title":"DemoJobMaterializedSystemResponse"},"DemoJobQualityResponse":{"properties":{"available":{"type":"boolean","title":"Available"},"all_passed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"All Passed"},"passed":{"type":"integer","minimum":0.0,"title":"Passed"},"total":{"type":"integer","minimum":0.0,"title":"Total"},"failing":{"type":"integer","minimum":0.0,"title":"Failing"},"critical_failures":{"type":"integer","minimum":0.0,"title":"Critical Failures"},"warning_failures":{"type":"integer","minimum":0.0,"title":"Warning Failures"},"failure_taxonomy":{"items":{"$ref":"#/components/schemas/DemoJobFailureClassResponse"},"type":"array","title":"Failure Taxonomy"}},"additionalProperties":false,"type":"object","required":["available","all_passed","passed","total","failing","critical_failures","warning_failures","failure_taxonomy"],"title":"DemoJobQualityResponse"},"DemoJobResetRequest":{"properties":{"confirm":{"type":"boolean","title":"Confirm","default":false}},"additionalProperties":false,"type":"object","title":"DemoJobResetRequest"},"DemoJobRuntimeResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"slug":{"type":"string","title":"Slug"},"publish_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publish Id"},"dashboard_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dashboard Url"},"staging_urls":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Staging Urls"}},"additionalProperties":false,"type":"object","required":["project_id","slug"],"title":"DemoJobRuntimeResponse"},"DemoJobScenarioManifestResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"company_id":{"type":"string","title":"Company Id"},"generated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Generated At"},"generator_version":{"type":"integer","minimum":1.0,"title":"Generator Version","default":1},"scenarios":{"items":{"type":"string"},"type":"array","title":"Scenarios"},"needles":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Needles"},"haystack_size":{"type":"integer","minimum":0.0,"title":"Haystack Size"},"needle_count":{"type":"integer","minimum":0.0,"title":"Needle Count"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"additionalProperties":false,"type":"object","required":["project_id","company_id","scenarios","needles","haystack_size","needle_count","metadata"],"title":"DemoJobScenarioManifestResponse"},"DemoJobServiceCoverageResponse":{"properties":{"service":{"type":"string","title":"Service"},"records":{"type":"integer","minimum":0.0,"title":"Records"},"status":{"type":"string","enum":["materialized","selected_empty"],"title":"Status"},"populated_record_types":{"type":"integer","minimum":0.0,"title":"Populated Record Types"},"present_value_keys":{"type":"integer","minimum":0.0,"title":"Present Value Keys"},"sources":{"additionalProperties":{"type":"integer"},"type":"object","title":"Sources"}},"additionalProperties":false,"type":"object","required":["service","records","status","populated_record_types","present_value_keys","sources"],"title":"DemoJobServiceCoverageResponse"},"DemoJobSimulationResponse":{"properties":{"available":{"type":"boolean","const":true,"title":"Available"},"mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mode"},"clock_position":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Clock Position"},"event_counter":{"type":"integer","minimum":0.0,"title":"Event Counter"},"last_advanced_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Advanced At"},"trickle_rate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trickle Rate"},"control_plane":{"type":"string","enum":["manual","server_owned"],"title":"Control Plane"},"server_owned":{"type":"boolean","title":"Server Owned"},"tick_interval_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tick Interval Seconds"},"tick_delta":{"anyOf":[{"$ref":"#/components/schemas/DemoJobTickDeltaResponse"},{"type":"null"}]},"simulated_seconds_per_wall_second":{"anyOf":[{"type":"integer","enum":[1,2,10,100]},{"type":"null"}],"title":"Simulated Seconds Per Wall Second"},"cadence":{"anyOf":[{"type":"string","const":"elapsed_time_credit"},{"type":"null"}],"title":"Cadence"}},"additionalProperties":false,"type":"object","required":["available","event_counter","control_plane","server_owned"],"title":"DemoJobSimulationResponse"},"DemoJobTickDeltaResponse":{"properties":{"days":{"type":"integer","title":"Days"},"hours":{"type":"integer","title":"Hours"},"minutes":{"type":"integer","title":"Minutes"}},"additionalProperties":false,"type":"object","required":["days","hours","minutes"],"title":"DemoJobTickDeltaResponse"},"DemoJobValidationErrorResponse":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/DemoJobValidationIssueResponse"},"type":"array","title":"Detail"}},"additionalProperties":false,"type":"object","required":["detail"],"title":"DemoJobValidationErrorResponse"},"DemoJobValidationIssueResponse":{"properties":{"type":{"type":"string","title":"Type"},"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Loc"},"msg":{"type":"string","title":"Msg"},"input":{"anyOf":[{},{"type":"null"}],"title":"Input"},"ctx":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ctx"}},"additionalProperties":false,"type":"object","required":["type","loc","msg"],"title":"DemoJobValidationIssueResponse"},"DetectedEntry":{"properties":{"entity_type":{"type":"string","title":"Entity Type"},"entity_id":{"type":"string","title":"Entity Id"},"finding":{"type":"string","title":"Finding"}},"type":"object","required":["entity_type","entity_id","finding"],"title":"DetectedEntry"},"DialsPatch":{"properties":{"growth":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Growth"},"churn":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Churn"},"chaos":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Chaos"},"fraud":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Fraud"},"seasonality":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Seasonality"},"maturity":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Maturity"},"trickle_rate":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"title":"Trickle Rate"},"growth_rate":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Growth Rate"},"churn_rate":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Churn Rate"},"chaos_factor":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Chaos Factor"},"fraud_rate":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Fraud Rate"},"seasonality_amplitude":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Seasonality Amplitude"}},"type":"object","title":"DialsPatch"},"EmailVerificationRequest":{"properties":{"pending_authentication_token":{"type":"string","title":"Pending Authentication Token"},"code":{"type":"string","title":"Code"}},"type":"object","required":["pending_authentication_token","code"],"title":"EmailVerificationRequest"},"ErrorCode":{"type":"string","enum":["CAPABILITY_NOT_FOUND","CREDENTIALS_MISSING","CREDENTIALS_INVALID","CREDENTIALS_INSUFFICIENT","RATE_LIMIT","NETWORK_ERROR","VALIDATION_ERROR","EXECUTION_ERROR","QUOTA_EXCEEDED","PERMISSION_DENIED"],"title":"ErrorCode","description":"Standardized capability error codes (Contract v1.0)."},"ErrorResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Always 'error' for error responses","default":"error"},"error_code":{"$ref":"#/components/schemas/ErrorCode","description":"Machine-readable error code for programmatic handling"},"error_message":{"type":"string","title":"Error Message","description":"Human-readable error description"},"retry_strategy":{"$ref":"#/components/schemas/RetryStrategy","description":"Recommended retry strategy for this error type"},"capability_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capability Key","description":"The capability that was being executed (if applicable)"},"details":{"additionalProperties":true,"type":"object","title":"Details","description":"Additional error context (e.g., field, service)"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"When the error occurred (UTC)"}},"type":"object","required":["error_code","error_message","retry_strategy"],"title":"ErrorResponse","description":"Standard error response format (Contract v1.0).\n\nCapability execution errors return HTTP 200 with status='error' to enable\nstructured error handling by AI agents.","example":{"capability_key":"vendor.create","details":{"org_id":"org_123","service":"quickbooks"},"error_code":"CREDENTIALS_MISSING","error_message":"No credentials found for service 'quickbooks'","retry_strategy":"human_intervention","status":"error","timestamp":"2025-10-18T12:00:00.123456"}},"GenerateProjectDataRequest":{"properties":{"employees":{"type":"integer","title":"Employees","default":12},"months_of_history":{"type":"integer","title":"Months Of History","default":24},"months":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Months"},"reference_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Reference Date"},"segment_mix":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Segment Mix"},"seasonal_pattern":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Seasonal Pattern"},"growth_pattern":{"type":"string","title":"Growth Pattern","default":"steady"},"acquisition_start_weight":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Acquisition Start Weight"},"geo_distribution":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Geo Distribution"},"customers_per_employee":{"type":"number","title":"Customers Per Employee","default":5.0},"payment_rate":{"type":"number","title":"Payment Rate","default":0.9},"quality_preset":{"type":"string","title":"Quality Preset","default":"realistic"},"archetype":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archetype"},"vendors":{"anyOf":[{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array"},{"type":"null"}],"title":"Vendors"},"connectors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Connectors"},"seed":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Seed"},"seedSplit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seedsplit"},"targetTransactionVolume":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":1.0},{"type":"null"}],"title":"Targettransactionvolume"},"charge_on_create":{"type":"boolean","title":"Charge On Create","default":false},"anomalyInjection":{"type":"boolean","title":"Anomalyinjection","default":false},"nativeExportFormats":{"items":{"type":"string"},"type":"array","title":"Nativeexportformats"},"scenario":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scenario"},"realism":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Realism"},"perPlatformRealism":{"additionalProperties":{"type":"string"},"type":"object","title":"Perplatformrealism"},"volumeMultipliers":{"additionalProperties":{"type":"number"},"type":"object","title":"Volumemultipliers"},"needles":{"additionalProperties":{"type":"integer"},"type":"object","title":"Needles"},"drift":{"additionalProperties":{"type":"integer"},"type":"object","title":"Drift"},"coherenceOn":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Coherenceon"},"periodMode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Periodmode"},"asOfDate":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Asofdate"},"durationMonths":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Durationmonths"},"periodFY":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Periodfy"},"periodFYEnd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Periodfyend"},"periodQuarter":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Periodquarter"},"periodCustomStart":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Periodcustomstart"},"periodCustomEnd":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Periodcustomend"}},"type":"object","title":"GenerateProjectDataRequest","description":"Request to generate data for a project."},"GenerateResponse":{"properties":{"project_id":{"type":"string","title":"Project Id"},"status":{"type":"string","title":"Status"},"archetype":{"type":"string","title":"Archetype"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed"},"config":{"additionalProperties":true,"type":"object","title":"Config"},"connectors":{"items":{"type":"string"},"type":"array","title":"Connectors"},"projections":{"additionalProperties":true,"type":"object","title":"Projections"},"credit":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Credit"}},"type":"object","required":["project_id","status","archetype"],"title":"GenerateResponse","description":"Response for data generation requests."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Service status: 'healthy' or 'degraded'"},"version":{"type":"string","title":"Version","description":"Fictix API version"},"capabilities_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Capabilities Count","description":"Total registered capabilities"},"services":{"additionalProperties":{"type":"string"},"type":"object","title":"Services","description":"Status of dependent services"},"deployment":{"additionalProperties":true,"type":"object","title":"Deployment","description":"Non-secret deployment identity: version, environment, release"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"Response timestamp (UTC)"}},"type":"object","required":["status","version"],"title":"HealthResponse","description":"Health check response for /health endpoint.","example":{"capabilities_count":82,"deployment":{"environment":"production","release":"backend@abcdef1","version":"1.0.0"},"services":{"projects":"ready"},"status":"healthy","timestamp":"2026-01-27T12:00:00.123456","version":"1.0.0"}},"InjectRequest":{"properties":{"scenarios":{"items":{"$ref":"#/components/schemas/ScenarioConfigBody"},"type":"array","title":"Scenarios"}},"type":"object","required":["scenarios"],"title":"InjectRequest"},"NativeBrowserOriginsRequest":{"properties":{"origins":{"items":{"type":"string"},"type":"array","title":"Origins"}},"type":"object","required":["origins"],"title":"NativeBrowserOriginsRequest","description":"Replacement allowlist for browser clients using the native API."},"NativeBrowserTokenRequest":{"properties":{"origin":{"type":"string","title":"Origin"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"subject":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Subject"},"expires_in_seconds":{"type":"integer","maximum":3600.0,"minimum":60.0,"title":"Expires In Seconds","default":900}},"type":"object","required":["origin"],"title":"NativeBrowserTokenRequest","description":"Server-side exchange request for a short-lived browser credential."},"OrganizationCompaniesResponse":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"companies":{"items":{"$ref":"#/components/schemas/OrganizationCompany"},"type":"array","title":"Companies"},"count":{"type":"integer","title":"Count"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["organization_id","companies","count","total","limit","offset"],"title":"OrganizationCompaniesResponse"},"OrganizationCompany":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"org_id":{"type":"string","title":"Org Id"}},"type":"object","required":["id","name","slug","status","org_id"],"title":"OrganizationCompany"},"OrganizationCreditTopUpRequestModel":{"properties":{"credits":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Credits"},"returnPath":{"type":"string","title":"Returnpath"}},"type":"object","required":["credits","returnPath"],"title":"OrganizationCreditTopUpRequestModel"},"OrganizationInviteTokenRequest":{"properties":{"token":{"type":"string","title":"Token"}},"type":"object","required":["token"],"title":"OrganizationInviteTokenRequest","description":"Request payload for previewing or accepting an invite token."},"OrganizationRunSubmissionRequestModel":{"properties":{"config":{"$ref":"#/components/schemas/RunConfigModel"},"expectedCost":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"}],"title":"Expectedcost"},"pricingVersion":{"type":"string","title":"Pricingversion"},"idempotencyKey":{"type":"string","maxLength":160,"minLength":8,"title":"Idempotencykey"}},"type":"object","required":["config","expectedCost","pricingVersion","idempotencyKey"],"title":"OrganizationRunSubmissionRequestModel"},"OrganizationWorkspaceAccessSyncRequest":{"properties":{"scope":{"type":"string","title":"Scope","default":"self"}},"type":"object","title":"OrganizationWorkspaceAccessSyncRequest","description":"Request payload for reconciling backend project workspace visibility."},"PasswordAuthAppMetadata":{"properties":{"provider":{"type":"string","const":"workos","title":"Provider"}},"type":"object","required":["provider"],"title":"PasswordAuthAppMetadata","description":"Application metadata returned with a successful password session."},"PasswordAuthRequest":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"PasswordAuthRequest"},"PasswordAuthResponse":{"properties":{"user":{"$ref":"#/components/schemas/PasswordAuthUser"},"access_token":{"type":"string","title":"Access Token"},"provider":{"type":"string","const":"workos","title":"Provider"}},"type":"object","required":["user","access_token","provider"],"title":"PasswordAuthResponse","description":"Successful password-authentication response envelope."},"PasswordAuthUser":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"user_metadata":{"$ref":"#/components/schemas/PasswordAuthUserMetadata"},"app_metadata":{"$ref":"#/components/schemas/PasswordAuthAppMetadata"},"last_sign_in_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Sign In At"}},"type":"object","required":["id","email","user_metadata","app_metadata","last_sign_in_at"],"title":"PasswordAuthUser","description":"Public user shape returned by the password-authentication endpoint."},"PasswordAuthUserMetadata":{"properties":{"display_name":{"type":"string","title":"Display Name"},"name":{"type":"string","title":"Name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"}},"type":"object","required":["display_name","name","avatar_url"],"title":"PasswordAuthUserMetadata","description":"Profile metadata returned with a successful password session."},"PasswordResetConfirmRequest":{"properties":{"token":{"type":"string","title":"Token"},"password":{"type":"string","title":"Password"}},"type":"object","required":["token","password"],"title":"PasswordResetConfirmRequest"},"PasswordResetRequest":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"PasswordResetRequest"},"PortalSessionRequest":{"properties":{"return_url":{"anyOf":[{"type":"string","minLength":1,"format":"uri"},{"type":"null"}],"title":"Return Url"},"return_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Path"}},"type":"object","title":"PortalSessionRequest"},"PrepaidScenarioConfigurationV2":{"properties":{"customer_id":{"type":"string","title":"Customer Id","description":"Existing canonical customer identifier."},"cash_account_id":{"type":"string","title":"Cash Account Id","description":"Existing active bank-linked cash account."},"deferred_liability_account_id":{"type":"string","title":"Deferred Liability Account Id","description":"Existing active deferred-liability account numbered 2200."},"revenue_account_id":{"type":"string","title":"Revenue Account Id","description":"Existing active same-currency revenue account."},"currency":{"type":"string","title":"Currency","description":"Three-letter uppercase company currency."},"start_date":{"type":"string","format":"date","title":"Start Date","description":"First monthly service recognition date."},"months_prepaid":{"type":"integer","maximum":36.0,"minimum":6.0,"title":"Months Prepaid","description":"Prepaid term length in months."},"churn_month":{"type":"integer","maximum":35.0,"minimum":1.0,"title":"Churn Month","description":"Configured cancellation month, before the final term month."},"contract_value":{"type":"string","title":"Contract Value","description":"Normalized exact-cent contract value as a decimal string."},"cancellation_policy":{"type":"string","enum":["refund_unearned","retain_unearned_as_liability","earned_termination_fee"],"title":"Cancellation Policy","description":"Configured disposition for the unearned balance."},"termination_fee_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Termination Fee Amount","description":"Exact-cent termination fee as a decimal string, or null."},"remaining_policy":{"anyOf":[{"type":"string","enum":["refund_unearned","retain_unearned_as_liability"]},{"type":"null"}],"title":"Remaining Policy","description":"Residual disposition for a fee policy, or null."}},"additionalProperties":false,"type":"object","required":["customer_id","cash_account_id","deferred_liability_account_id","revenue_account_id","currency","start_date","months_prepaid","churn_month","contract_value","cancellation_policy","termination_fee_amount","remaining_policy"],"title":"PrepaidScenarioConfigurationV2","description":"Normalized, customer-visible terms for the supported prepaid scenario."},"ProfileUpdateRequest":{"properties":{"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"}},"type":"object","title":"ProfileUpdateRequest"},"ProjectVariantRequest":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"runConfig":{"$ref":"#/components/schemas/VariantRunConfig"},"charge_on_create":{"type":"boolean","title":"Charge On Create","default":false}},"type":"object","required":["name","runConfig"],"title":"ProjectVariantRequest","description":"Create a queued variant run from an existing project genome."},"RegenerateRequestModel":{"properties":{"workspaceId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workspaceid"},"mode":{"type":"string","enum":["full","ledger","rows","variant"],"title":"Mode"},"ledgerKey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ledgerkey"},"rowIds":{"items":{"type":"string"},"type":"array","title":"Rowids"},"reseed":{"type":"boolean","title":"Reseed","default":true},"expectedCost":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Expectedcost"},"pricingVersion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pricingversion"},"idempotencyKey":{"type":"string","maxLength":160,"minLength":8,"title":"Idempotencykey"}},"type":"object","required":["mode","idempotencyKey"],"title":"RegenerateRequestModel"},"ResendOrganizationInviteRequest":{"properties":{"expires_in_days":{"type":"integer","title":"Expires In Days","default":7}},"type":"object","title":"ResendOrganizationInviteRequest","description":"Request payload for rotating one org invite."},"ResendVerificationRequest":{"properties":{"pending_authentication_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pending Authentication Token"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"}},"type":"object","title":"ResendVerificationRequest"},"ResetRequest":{"properties":{"confirm":{"type":"string","title":"Confirm"},"seed":{"type":"boolean","title":"Seed","default":true}},"type":"object","required":["confirm"],"title":"ResetRequest"},"RetryStrategy":{"type":"string","enum":["human_intervention","backoff","none"],"title":"RetryStrategy","description":"Recommended retry strategy for each error type."},"RunConfigModel":{"properties":{"domain":{"type":"string","title":"Domain","default":""},"companyName":{"type":"string","title":"Companyname"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stage"},"connectorIds":{"items":{"type":"string"},"type":"array","title":"Connectorids"},"transactionVolume":{"type":"integer","minimum":0.0,"title":"Transactionvolume"},"monthsOfHistory":{"type":"integer","minimum":1.0,"title":"Monthsofhistory"},"anomalyInjection":{"type":"boolean","title":"Anomalyinjection"},"nativeExportFormats":{"items":{"type":"string"},"type":"array","title":"Nativeexportformats"},"seed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seed"}},"type":"object","required":["companyName","connectorIds","transactionVolume","monthsOfHistory","anomalyInjection","nativeExportFormats"],"title":"RunConfigModel"},"RunSubmissionRequestModel":{"properties":{"workspaceId":{"type":"string","title":"Workspaceid"},"config":{"$ref":"#/components/schemas/RunConfigModel"},"expectedCost":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"}],"title":"Expectedcost"},"pricingVersion":{"type":"string","title":"Pricingversion"},"idempotencyKey":{"type":"string","maxLength":160,"minLength":8,"title":"Idempotencykey"}},"type":"object","required":["workspaceId","config","expectedCost","pricingVersion","idempotencyKey"],"title":"RunSubmissionRequestModel"},"ScenarioConfigBody":{"properties":{"id":{"type":"string","title":"Id"},"params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Params"}},"type":"object","required":["id"],"title":"ScenarioConfigBody"},"ScenarioConfigurationsV2Response":{"properties":{"configuration_version":{"type":"integer","const":2,"title":"Configuration Version","description":"Configuration envelope version."},"configurations":{"additionalProperties":{"$ref":"#/components/schemas/PrepaidScenarioConfigurationV2"},"propertyNames":{"const":"rev-rec-prepaid-churn"},"type":"object","title":"Configurations","description":"Saved normalized terms keyed by scenario ID. Currently the only supported entry is rev-rec-prepaid-churn."}},"additionalProperties":false,"type":"object","required":["configuration_version","configurations"],"title":"ScenarioConfigurationsV2Response","description":"Versioned envelope returned by saved scenario-configuration reads."},"ScenarioGenerateRequest":{"properties":{"description":{"type":"string","title":"Description"},"severity":{"type":"string","title":"Severity","default":"medium"}},"type":"object","required":["description"],"title":"ScenarioGenerateRequest"},"ScenarioSpec":{"properties":{"scenario_id":{"type":"string","title":"Scenario Id"},"severity":{"type":"string","title":"Severity","default":"medium"},"required":{"type":"boolean","title":"Required","default":true}},"type":"object","required":["scenario_id"],"title":"ScenarioSpec"},"SignUpRequest":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"}},"type":"object","required":["email","password"],"title":"SignUpRequest"},"SnapshotRequest":{"properties":{"name":{"type":"string","title":"Name"}},"type":"object","required":["name"],"title":"SnapshotRequest"},"StagingBypassRequest":{"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","title":"StagingBypassRequest"},"StartRequest":{"properties":{"seed":{"type":"integer","title":"Seed","default":42},"dials":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dials"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"}},"type":"object","title":"StartRequest"},"StepRequest":{"properties":{"count":{"type":"integer","maximum":1000.0,"minimum":1.0,"title":"Count"}},"type":"object","required":["count"],"title":"StepRequest"},"SubmitTestRunRequest":{"properties":{"matrix_id":{"type":"string","title":"Matrix Id"},"detected":{"items":{"$ref":"#/components/schemas/DetectedEntry"},"type":"array","title":"Detected"}},"type":"object","required":["matrix_id"],"title":"SubmitTestRunRequest"},"ThresholdsBody":{"properties":{"min_recall":{"type":"number","title":"Min Recall","default":0.95},"min_precision":{"type":"number","title":"Min Precision","default":0.8},"critical_must_pass":{"type":"boolean","title":"Critical Must Pass","default":true}},"type":"object","title":"ThresholdsBody"},"ToolExecutionRequest":{"properties":{"capability_key":{"type":"string","maxLength":255,"title":"Capability Key","description":"The capability being requested (e.g., 'vendor.create')"},"org_id":{"type":"string","maxLength":255,"title":"Org Id","description":"Organization ID for multi-tenancy"},"user_id":{"type":"string","maxLength":255,"title":"User Id","description":"Claimed user ID for credential lookup and audit"},"turn_id":{"type":"string","maxLength":255,"title":"Turn Id","description":"Turn ID for idempotency (prevents duplicate executions) - REQUIRED"},"args":{"additionalProperties":true,"type":"object","title":"Args","description":"Arguments for the tool execution"},"use_delegation":{"type":"boolean","title":"Use Delegation","description":"For agent credentials: prefer delegated access over system credentials","default":false},"session_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Session Id","description":"Session ID for event correlation (passed via X-Session-ID header or body)"}},"type":"object","required":["capability_key","org_id","user_id","turn_id"],"title":"ToolExecutionRequest","description":"Request model for tool execution (Contract v1.0 compliant).","example":{"args":{"email":"[email protected]","vendor_name":"Acme Inc."},"capability_key":"vendor.create","org_id":"org_12345","session_id":"01936b3a-4f2e-7000-8000-abc123def456","turn_id":"turn_01HZ8Y3K5G4N2M6X9W7Q","use_delegation":false,"user_id":"user_67890"}},"ToolExecutionResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Execution status: 'success' or 'error'"},"capability_key":{"type":"string","title":"Capability Key","description":"The capability that was executed"},"tool_used":{"type":"string","title":"Tool Used","description":"The actual tool/connector used (e.g., 'quickbooks.create_vendor')"},"outputs":{"additionalProperties":true,"type":"object","title":"Outputs","description":"Outputs from the execution"},"logs":{"items":{"type":"string"},"type":"array","title":"Logs","description":"Execution logs"},"credential_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credential Type","description":"Type of credential used: 'agent' or 'customer' or None"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if status is 'error'"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp","description":"Execution timestamp"}},"type":"object","required":["status","capability_key","tool_used"],"title":"ToolExecutionResponse","description":"Response model for tool execution (success case).\n\nFollows the Fictix capability execution contract.\nRequired fields: status, capability_key, tool_used","example":{"capability_key":"vendor.create","credential_type":"customer","logs":["Successfully created vendor in QuickBooks"],"outputs":{"created_at":"2025-10-18T12:00:00Z","status":"pending_w9","vendor_id":"qb:123-xyz"},"status":"success","timestamp":"2025-10-18T12:00:00.123456","tool_used":"quickbooks.create_vendor"}},"UpdateOrganizationMemberRequest":{"properties":{"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"}},"type":"object","title":"UpdateOrganizationMemberRequest","description":"Request payload for mutating an existing org member."},"UpdateOrganizationRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier"},"meta":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","title":"UpdateOrganizationRequest","description":"Request payload for updating an organization."},"UpdateProjectRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Id"},"email_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Domain"},"archetype":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archetype"},"employee_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Employee Count"},"company_age_months":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Company Age Months"},"selected_services":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Selected Services"},"dials":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Dials"},"seedSplit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seedsplit"},"retention_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Retention Expires At"},"retention_protected":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Retention Protected"}},"type":"object","title":"UpdateProjectRequest","description":"Request to partially update a project."},"UpsertOrganizationMemberRequest":{"properties":{"user_id":{"type":"string","title":"User Id"},"role":{"type":"string","title":"Role","default":"member"},"status":{"type":"string","title":"Status","default":"active"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"}},"type":"object","required":["user_id"],"title":"UpsertOrganizationMemberRequest","description":"Request payload for adding/updating an org member."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VariantRunConfig":{"properties":{"volume":{"type":"integer","maximum":1000000.0,"minimum":1.0,"title":"Volume"},"monthsOfHistory":{"type":"integer","maximum":120.0,"minimum":1.0,"title":"Monthsofhistory"},"anomalyInjection":{"type":"boolean","title":"Anomalyinjection","default":false},"nativeExports":{"items":{"type":"string"},"type":"array","title":"Nativeexports"},"connectors":{"items":{"type":"string"},"type":"array","title":"Connectors"}},"type":"object","required":["volume","monthsOfHistory"],"title":"VariantRunConfig","description":"Run configuration for regenerating an existing project variant."},"WebhookCreateRequest":{"properties":{"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"events":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Events"},"secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secret"}},"type":"object","required":["url"],"title":"WebhookCreateRequest"},"WebhookTestRequest":{"properties":{"event_type":{"type":"string","title":"Event Type","default":"fictix.test"}},"type":"object","title":"WebhookTestRequest"},"WorkspaceSnapshotRequest":{"properties":{"backend_project_id":{"type":"string","title":"Backend Project Id"},"backend_org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Backend Org Id"},"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"publish_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publish Id"},"archetype":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archetype"},"services":{"items":{"type":"string"},"type":"array","title":"Services","default":[]},"dials":{"additionalProperties":true,"type":"object","title":"Dials","default":{}},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","default":{}}},"type":"object","required":["backend_project_id","slug","name"],"title":"WorkspaceSnapshotRequest"},"PartnerError":{"type":"object","description":"Error envelope. detail can be a human-readable message or a structured object with a machine-readable code.","required":["detail"],"properties":{"detail":{"oneOf":[{"type":"string"},{"type":"object","additionalProperties":true}]},"request_id":{"type":"string","description":"Opaque request identifier for support."}},"additionalProperties":true},"PartnerLinkSet":{"type":"object","description":"Relative links to the normalized demo-job resources.","properties":{"self":{"type":"string"},"status":{"type":"string"},"quality":{"type":"string"},"bundle":{"type":"string"}},"additionalProperties":true},"DemoJob":{"type":"object","description":"Stable control-plane resource for one generated company.","required":["object","contract_version","id","status"],"properties":{"object":{"type":"string","enum":["demo_job"]},"contract_version":{"type":"string","description":"Versioned Fictix partner contract identifier.","example":"2026-07-17"},"regeneration_required":{"type":"boolean","description":"True when the retained company predates the current accounting contract and must be regenerated before import."},"id":{"type":"string"},"status":{"type":"string","enum":["created","generating","ready","error","unknown"]},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"generated_at":{"type":["string","null"],"format":"date-time"},"links":{"$ref":"#/components/schemas/PartnerLinkSet"},"company":{"type":"object","additionalProperties":true},"runtime":{"type":"object","additionalProperties":true},"dataset_summary":{"type":"object","additionalProperties":true},"quality":{"type":"object","additionalProperties":true},"simulation":{"type":"object","additionalProperties":true},"scenario_manifest":{"type":"object","additionalProperties":true,"description":"Optional for backwards compatibility. New create responses omit answer keys; fetch the authorized manifest route instead."},"credentials":{"type":"object","description":"One-time project runtime credentials. Treat api_key as a server-side secret.","properties":{"api_key":{"type":"string","format":"password","x-fictix-secret":true},"api_key_id":{"type":"string"},"api_key_prefix":{"type":"string"}},"required":["api_key","api_key_id","api_key_prefix"],"additionalProperties":false},"credit":{"type":"object","additionalProperties":true},"handoff":{"type":"object","additionalProperties":true}},"additionalProperties":false},"DemoJobList":{"type":"object","required":["object","contract_version","count","jobs"],"properties":{"object":{"type":"string","enum":["list"]},"contract_version":{"type":"string","example":"2026-07-17"},"count":{"type":"integer","minimum":0},"jobs":{"type":"array","items":{"$ref":"#/components/schemas/DemoJob"}}},"additionalProperties":true},"DemoJobStatus":{"type":"object","required":["object","contract_version","job_id","status"],"properties":{"object":{"type":"string","enum":["demo_job_status"]},"contract_version":{"type":"string","example":"2026-07-17"},"job_id":{"type":"string"},"status":{"type":"string"},"generated_at":{"type":["string","null"],"format":"date-time"},"error_message":{"type":["string","null"]},"links":{"$ref":"#/components/schemas/PartnerLinkSet"},"company":{"type":"object","additionalProperties":true},"dataset_summary":{"type":"object","additionalProperties":true},"quality":{"type":"object","additionalProperties":true},"simulation":{"type":"object","additionalProperties":true}},"additionalProperties":true},"DemoJobQuality":{"type":"object","required":["object","contract_version","job_id","summary","checks"],"properties":{"object":{"type":"string","enum":["demo_job_quality"]},"contract_version":{"type":"string","example":"2026-07-17"},"job_id":{"type":"string"},"summary":{"type":"object","additionalProperties":true},"checks":{"type":"array","items":{"type":"object","additionalProperties":true}},"certificate":{"$ref":"#/components/schemas/ValidationCertificate"}},"additionalProperties":true},"ValidationCertificate":{"type":"object","description":"Validation and lineage certificate for a generated dataset.","properties":{"object":{"type":"string"},"job_id":{"type":"string"},"project_id":{"type":"string"},"summary":{"type":"object","additionalProperties":true},"lineage":{"type":"object","additionalProperties":true},"checks":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"RuntimeReadiness":{"type":"object","description":"Static, trickle, and continuous runtime-readiness state.","required":["object","schema_version","project_id","status","current_mode","modes","lineage"],"properties":{"object":{"type":"string","enum":["runtime_readiness"]},"schema_version":{"type":"integer","enum":[1]},"project_id":{"type":"string"},"status":{"type":"string","enum":["blocked","static_ready","trickle_ready","continuous_ready"]},"current_mode":{"type":"string","enum":["static","trickle","continuous"]},"modes":{"type":"object","required":["static","trickle","continuous"],"properties":{"static":{"type":"object","required":["status","supported","reasons","evidence"],"properties":{"status":{"type":"string","enum":["blocked","degraded","ready"]},"supported":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}},"evidence":{"type":"object","additionalProperties":true}},"additionalProperties":false},"trickle":{"type":"object","required":["status","supported","reasons","evidence"],"properties":{"status":{"type":"string","enum":["blocked","degraded","ready"]},"supported":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}},"evidence":{"type":"object","additionalProperties":true}},"additionalProperties":false},"continuous":{"type":"object","required":["status","supported","reasons","evidence"],"properties":{"status":{"type":"string","enum":["blocked","degraded","ready"]},"supported":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}},"evidence":{"type":"object","additionalProperties":true}},"additionalProperties":false}},"additionalProperties":false},"lineage":{"type":"object","required":["certificate_hash","scenario_manifest_hash"],"properties":{"certificate_hash":{"type":["string","null"]},"scenario_manifest_hash":{"type":["string","null"]}},"additionalProperties":false}},"additionalProperties":false},"EvalPackManifest":{"type":"object","description":"Shareable evaluation/data-pack manifest with planted-truth context.","properties":{"object":{"type":"string"},"contract_version":{"type":"string"},"job_id":{"type":"string"},"certificate":{"$ref":"#/components/schemas/ValidationCertificate"},"runtime_readiness":{"$ref":"#/components/schemas/RuntimeReadiness"},"scenarios":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"DemoBundle":{"type":"object","required":["object","contract_version","job","included_entities","total_records","entities"],"properties":{"object":{"type":"string","enum":["demo_bundle"]},"contract_version":{"type":"string","example":"2026-07-17"},"job":{"$ref":"#/components/schemas/DemoJob"},"lineage":{"type":"object","additionalProperties":true},"included_entities":{"type":"array","items":{"type":"string"}},"total_records":{"type":"integer","minimum":0},"record_limit_applied":{"type":"integer","minimum":1},"entities":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"additionalProperties":true},"DemoEntityPage":{"type":"object","required":["object","contract_version","job_id","entity","count","limit","offset","data"],"properties":{"object":{"type":"string","enum":["demo_entity_page"]},"contract_version":{"type":"string","example":"2026-07-17"},"job_id":{"type":"string"},"lineage":{"type":"object","additionalProperties":true},"entity":{"type":"string"},"count":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"data":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"DemoEntityExport":{"type":"object","required":["object","contract_version","job_id","entity","format","count","data"],"properties":{"object":{"type":"string","enum":["demo_entity_export"]},"contract_version":{"type":"string","example":"2026-07-17"},"job_id":{"type":"string"},"lineage":{"type":"object","additionalProperties":true},"entity":{"type":"string"},"format":{"type":"string","enum":["json"]},"count":{"type":"integer","minimum":0},"data":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"DemoJobReset":{"type":"object","required":["object","contract_version","status","job"],"properties":{"object":{"type":"string","enum":["demo_job_reset"]},"contract_version":{"type":"string","example":"2026-07-17"},"status":{"type":"string","enum":["reset"]},"job":{"$ref":"#/components/schemas/DemoJob"}},"additionalProperties":true},"SimulationState":{"type":"object","description":"Simulation state. Fields vary slightly by simulation mode.","properties":{"company_id":{"type":"string"},"clock_position":{"type":"string","format":"date-time"},"mode":{"type":"string"},"dial_config":{"type":"object","additionalProperties":true}},"additionalProperties":true},"SimulationAdvance":{"type":"object","required":["events_generated","clock_position","new_events"],"properties":{"events_generated":{"type":"integer","minimum":0},"clock_position":{"type":"string","format":"date-time"},"new_events":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"Checkpoint":{"type":"object","description":"Named simulation checkpoint.","properties":{"id":{"type":"string"},"name":{"type":"string"},"created_at":{"type":"string","format":"date-time"}},"additionalProperties":true},"CheckpointList":{"type":"object","properties":{"checkpoints":{"type":"array","items":{"$ref":"#/components/schemas/Checkpoint"}},"count":{"type":"integer","minimum":0}},"additionalProperties":true},"Scenario":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"},"params":{"type":"object","additionalProperties":true}},"additionalProperties":true},"ScenarioList":{"type":"object","properties":{"scenarios":{"type":"array","items":{"$ref":"#/components/schemas/Scenario"}},"count":{"type":"integer","minimum":0}},"additionalProperties":true},"ScenarioSuggestionList":{"type":"object","properties":{"suggestions":{"type":"array","items":{"type":"object","additionalProperties":true}},"count":{"type":"integer","minimum":0}},"additionalProperties":true},"ScenarioManifest":{"type":"object","description":"Planted-truth scenario manifest used by evaluation workflows. The demo-job management route requires an organization admin or owner.","properties":{"scenarios":{"type":"array","items":{"$ref":"#/components/schemas/Scenario"}},"manifest":{"type":"object","additionalProperties":true}},"additionalProperties":true},"DeletedResource":{"type":"object","properties":{"deleted":{"type":"boolean"},"id":{"type":"string"},"webhook_id":{"type":"string"},"matrix_id":{"type":"string"},"scenario_id":{"type":"string"}},"additionalProperties":true},"EventRecord":{"type":"object","properties":{"id":{"type":"string"},"company_id":{"type":"string"},"environment_id":{"type":["string","null"]},"schema_version":{"type":"string"},"event_type":{"type":"string"},"occurred_at":{"type":["string","null"],"format":"date-time"},"recorded_at":{"type":["string","null"],"format":"date-time"},"actor_kind":{"type":["string","null"]},"actor_id":{"type":["string","null"]},"entity_type":{"type":["string","null"]},"entity_id":{"type":["string","null"]},"correlation_id":{"type":["string","null"]},"parent_id":{"type":["string","null"]},"data":{"type":"object","additionalProperties":true},"mutation":{"oneOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"projection_refs":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"null"}]},"audit_meta":{"oneOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"layer":{"type":"integer","minimum":1}},"additionalProperties":true},"EventList":{"type":"object","properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/EventRecord"}},"count":{"type":"integer","minimum":0},"next_cursor":{"type":["string","null"]}},"additionalProperties":true},"Event":{"type":"object","properties":{"event":{"$ref":"#/components/schemas/EventRecord"},"causal_chain":{"type":"array","items":{"$ref":"#/components/schemas/EventRecord"}}},"additionalProperties":true},"TestMatrix":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","example":"test_matrix"},"name":{"type":"string"},"scenarios":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"TestMatrixList":{"type":"object","properties":{"test_matrices":{"type":"array","items":{"$ref":"#/components/schemas/TestMatrix"}},"count":{"type":"integer","minimum":0}},"additionalProperties":true},"TestRun":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","example":"test_run"},"status":{"type":"string"},"score":{"type":"object","additionalProperties":true},"findings":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"TestRunList":{"type":"object","properties":{"test_runs":{"type":"array","items":{"$ref":"#/components/schemas/TestRun"}},"count":{"type":"integer","minimum":0}},"additionalProperties":true},"ProjectRuntimeInfo":{"type":"object","description":"Console-created company metadata for a runtime project.","properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"domain":{"type":["string","null"]},"status":{"type":"string"},"record_counts":{"type":"object","additionalProperties":true},"system_record_counts":{"type":"object","additionalProperties":true},"record_counts_by_service":{"type":"object","additionalProperties":true},"config":{"type":"object","additionalProperties":true},"generated_at":{"type":["string","null"],"format":"date-time"}},"additionalProperties":true},"RuntimeCapabilities":{"type":"object","properties":{"capabilities":{"type":"array","items":{"type":"object","additionalProperties":true}},"count":{"type":"integer","minimum":0},"categories":{"type":"object","additionalProperties":true}},"additionalProperties":true},"RuntimeEntityPage":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"count":{"type":"integer","minimum":0},"total_count":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"next_cursor":{"type":["string","null"]},"service":{"type":["string","null"]}},"additionalProperties":true},"WebhookSubscription":{"type":"object","properties":{"id":{"type":"string"},"company_id":{"type":"string"},"url":{"type":"string","format":"uri"},"events":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"has_secret":{"type":"boolean"},"active":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"additionalProperties":true},"WebhookList":{"type":"object","properties":{"webhooks":{"type":"array","items":{"$ref":"#/components/schemas/WebhookSubscription"}},"count":{"type":"integer","minimum":0}},"additionalProperties":true},"WebhookDeliveryQueued":{"type":"object","properties":{"queued":{"type":"boolean"},"webhook_id":{"type":"string"},"event_type":{"type":"string"},"url":{"type":"string","format":"uri"}},"additionalProperties":true},"NativeResponse":{"type":"object","description":"Provider-shaped runtime payload. Query the catalog object schema before binding to provider-specific fields.","additionalProperties":true},"CatalogCollection":{"type":"object","required":["object","contract_version","collection","count","items"],"properties":{"object":{"type":"string","enum":["catalog_collection"]},"contract_version":{"type":"string","example":"2026-07-17"},"collection":{"type":"string"},"count":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"CatalogObjectSchema":{"type":"object","required":["object","contract_version","service","object_type","columns"],"properties":{"object":{"type":"string","enum":["catalog_object_schema"]},"contract_version":{"type":"string","example":"2026-07-17"},"service":{"type":"string"},"object_type":{"type":"string"},"record_type":{"type":"string"},"fidelity":{"type":"string","enum":["native","generic"]},"columns":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true},"CatalogExportPackSchema":{"type":"object","required":["object","contract_version","target","schema"],"properties":{"object":{"type":"string","enum":["catalog_export_pack_schema"]},"contract_version":{"type":"string","example":"2026-07-17"},"target":{"type":"string"},"schema":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Access token for an authenticated Fictix user. Use this in browser-backed or user-scoped server flows."},"AdminApiKey":{"type":"apiKey","in":"header","name":"X-Admin-Key","description":"Fictix-approved server-to-server management credential. It is not a self-service onboarding key; customers start in the Console and use project-scoped runtime keys for company data."},"ProjectApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Project-scoped runtime credential issued by the Fictix Console. Use it only for /api/v1/orgs/{slug} runtime routes. Keys default to read; ground-truth manifests require the separate, non-default ground_truth scope."},"NativeBrowserBearer":{"type":"http","scheme":"bearer","bearerFormat":"FictixBrowserToken","description":"Short-lived fbt_ token bound to one project, registered browser origin, scope set, and project incarnation. Obtain it through the server-side /orgs/{slug}/browser-tokens exchange."}}},"tags":[{"name":"execute","description":"Synthetic capability execution"},{"name":"projects","description":"Project lifecycle management"},{"name":"demo-jobs","description":"Partner-facing demo data API built on normalized job resources"},{"name":"catalog","description":"Read-only partner discovery surface for archetypes, entities, presets, and services"},{"name":"organizations","description":"Top-level tenant/workspace hierarchy"},{"name":"auth","description":"Customer login and session management"},{"name":"generate","description":"Synthetic data generation"},{"name":"orgs","description":"Per-project org-scoped APIs with API key auth"},{"name":"webhooks","description":"Webhook subscriptions and event dispatch"},{"name":"simulation","description":"Simulation clock and event generation"},{"name":"events","description":"Event feed and query"},{"name":"apollo","description":"Company enrichment via Apollo.io"},{"name":"reference","description":"Scenarios, presets, archetypes, targets, jobs, pipelines"},{"name":"test-matrices","description":"Test matrices and regression tracking"},{"name":"personas","description":"Interactive role agents grounded in company data"},{"name":"billing","description":"Stripe billing, subscriptions, portal access, and entitlements"},{"name":"credits","description":"Generate-page credit balances, ledger, run debits, and top-ups"},{"name":"audit","description":"Usage metering, quota enforcement, audit export"},{"name":"root","description":"Health checks and service info"}],"x-fictix-partner-contract":{"version":"2026-07-05","primary_namespace":"/api/v1/demo-jobs","catalog_namespace":"/api/v1/catalog"}}