{"openapi":"3.1.0","info":{"title":"Vera API","version":"1.0.0"},"paths":{"/health":{"get":{"summary":"Health","description":"Return a minimal health signal for load balancers and smoke tests.","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/ready":{"get":{"summary":"Ready","description":"Deep health check: verifies database and Redis connectivity.\n\nCelery worker liveness is intentionally excluded — workers are separate\nprocesses (or separate App Runner services) and their absence must not\ncause the API to report itself unhealthy. Use GET /workers/health to\ncheck Celery worker status independently.","operationId":"ready_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"database":"ok","redis":"ok"}}}}}}}}},"/workers/health":{"get":{"summary":"Workers Health","description":"Report Celery worker liveness.\n\nQueries active workers via Celery inspect with a short timeout so the\nresponse returns quickly even when workers are unavailable. Returns 200\nwhen at least one worker is active, 503 when none are reachable or Celery\nis not configured.\n\nNot intended for external traffic — used by Docker healthchecks, the\n/ready endpoint, and internal monitoring.","operationId":"workers_health_workers_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/status":{"get":{"summary":"Status","description":"Return public component health, recent incidents, and rolling uptime indicators.","operationId":"status_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"operational","updated_at":"2026-03-09T12:00:00Z","uptime_30d":99.98,"uptime_90d":99.95,"components":[{"name":"api","status":"operational","detail":"Healthy"},{"name":"database","status":"operational","detail":"Primary database reachable"}],"incidents":[]}}}}}}}}},"/metrics":{"get":{"summary":"Metrics","description":"Expose Prometheus-format application metrics when metrics are enabled.","operationId":"metrics_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/auth/login":{"get":{"tags":["auth"],"summary":"Login","description":"Start the login flow or use local mock auth when configured.","operationId":"login_auth_login_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Login Auth Login Get"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}}}}},"/auth/callback":{"get":{"tags":["auth"],"summary":"Callback","description":"Complete the auth callback and establish the application session.","operationId":"callback_auth_callback_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Callback Auth Callback Get"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}}}}},"/auth/logout":{"get":{"tags":["auth"],"summary":"Logout Get","description":"Support browser logout via GET for legacy clients.","operationId":"logout_get_auth_logout_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Logout Get Auth Logout Get"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}}}},"post":{"tags":["auth"],"summary":"Logout","description":"Log out the current user and revoke the active session.","operationId":"logout_auth_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Logout Auth Logout Post"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}}}}},"/auth/me":{"get":{"tags":["auth"],"summary":"Me","description":"Return the active session user, organization, and policy.","operationId":"me_auth_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthSessionResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"user":{"id":"string","email":"string","name":"string","mfa_enabled":true,"mfa_recovery_codes_remaining":1,"email_verification_required":true,"email_verified_at":"string"},"org":{"id":"string","name":"string","slug":"string","onboarding_completed_at":"2026-03-09T12:00:00Z"},"role":"string","custom_role":{},"platform_admin":true,"policy":{"require_sso":true,"require_mfa":true,"session_ttl_hours":1,"group_sync_mode":"string","chat_retention_days":1,"document_retention_days":1,"directory_id":"string","data_region":"string","ip_allowlist":"string","custom_logo_url":"string","custom_primary_color":"string","custom_support_email":"string"},"features":{"web_search":true}}}}}}}}}},"/auth/organizations":{"get":{"tags":["auth"],"summary":"List Organizations","description":"List every organization membership for the current user.","operationId":"list_organizations_auth_organizations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/OrganizationMembershipResponse"},"type":"array","title":"Response List Organizations Auth Organizations Get"},"examples":{"default":{"summary":"Example 200 response","value":[{"id":"string","name":"string","slug":"string","role":"string","custom_role_name":"string","is_active":true}]}}}}}}}},"/auth/switch-org":{"post":{"tags":["auth"],"summary":"Switch Org","description":"Switch the active session to another organization membership.","operationId":"switch_org_auth_switch_org_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwitchOrgRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthSessionResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"user":{"id":"string","email":"string","name":"string","mfa_enabled":true,"mfa_recovery_codes_remaining":1,"email_verification_required":true,"email_verified_at":"string"},"org":{"id":"string","name":"string","slug":"string","onboarding_completed_at":"2026-03-09T12:00:00Z"},"role":"string","custom_role":{},"platform_admin":true,"policy":{"require_sso":true,"require_mfa":true,"session_ttl_hours":1,"group_sync_mode":"string","chat_retention_days":1,"document_retention_days":1,"directory_id":"string","data_region":"string","ip_allowlist":"string","custom_logo_url":"string","custom_primary_color":"string","custom_support_email":"string"},"features":{"web_search":true}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/auth/mfa/status":{"get":{"tags":["auth"],"summary":"Mfa Status","description":"Return MFA enrollment status for the current user.","operationId":"mfa_status_auth_mfa_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Mfa Status Auth Mfa Status Get"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}}}}},"/auth/mfa/setup":{"post":{"tags":["auth"],"summary":"Mfa Setup","description":"Create a TOTP setup secret and setup token.","operationId":"mfa_setup_auth_mfa_setup_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Mfa Setup Auth Mfa Setup Post"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}}}}},"/auth/mfa/enable":{"post":{"tags":["auth"],"summary":"Mfa Enable","description":"Enable TOTP MFA for the current session user.","operationId":"mfa_enable_auth_mfa_enable_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFAEnableRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Mfa Enable Auth Mfa Enable Post"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/auth/mfa/recovery/regenerate":{"post":{"tags":["auth"],"summary":"Mfa Recovery Regenerate","description":"Rotate MFA recovery codes after validating a second factor.","operationId":"mfa_recovery_regenerate_auth_mfa_recovery_regenerate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFACodeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Mfa Recovery Regenerate Auth Mfa Recovery Regenerate Post"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/auth/mfa/disable":{"post":{"tags":["auth"],"summary":"Mfa Disable","description":"Disable TOTP MFA if tenant policy allows it.","operationId":"mfa_disable_auth_mfa_disable_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFACodeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Mfa Disable Auth Mfa Disable Post"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/auth/mfa/verify":{"post":{"tags":["auth"],"summary":"Mfa Verify Challenge","description":"Complete a pending MFA challenge and establish the session.","operationId":"mfa_verify_challenge_auth_mfa_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFAVerifyChallengeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Mfa Verify Challenge Auth Mfa Verify Post"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/auth/passkeys/available":{"get":{"tags":["auth"],"summary":"Passkey Availability","description":"Report whether WebAuthn is usable on this deployment. No session required.","operationId":"passkey_availability_auth_passkeys_available_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Passkey Availability Auth Passkeys Available Get"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}}}}},"/auth/passkeys":{"get":{"tags":["auth"],"summary":"List Passkeys","description":"List registered passkeys for the current user.","operationId":"list_passkeys_auth_passkeys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response List Passkeys Auth Passkeys Get"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}}}}},"/auth/passkeys/{passkey_id}":{"delete":{"tags":["auth"],"summary":"Delete Passkey","description":"Delete a registered passkey.","operationId":"delete_passkey_auth_passkeys__passkey_id__delete","parameters":[{"name":"passkey_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Passkey Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Delete Passkey Auth Passkeys Passkey Id Delete"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/auth/passkeys/register/options":{"post":{"tags":["auth"],"summary":"Passkey Register Options","description":"Generate WebAuthn registration options.","operationId":"passkey_register_options_auth_passkeys_register_options_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Passkey Register Options Auth Passkeys Register Options Post"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}}}}},"/auth/passkeys/register/verify":{"post":{"tags":["auth"],"summary":"Passkey Register Verify","description":"Verify a completed WebAuthn registration ceremony.","operationId":"passkey_register_verify_auth_passkeys_register_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasskeyRegistrationFinishRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Passkey Register Verify Auth Passkeys Register Verify Post"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/auth/mfa/passkey/options":{"post":{"tags":["auth"],"summary":"Mfa Passkey Options","description":"Generate WebAuthn authentication options for an MFA challenge.","operationId":"mfa_passkey_options_auth_mfa_passkey_options_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFAPasskeyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Mfa Passkey Options Auth Mfa Passkey Options Post"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/auth/mfa/passkey/verify":{"post":{"tags":["auth"],"summary":"Mfa Passkey Verify","description":"Verify a passkey response for a pending MFA challenge.","operationId":"mfa_passkey_verify_auth_mfa_passkey_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFAPasskeyVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Mfa Passkey Verify Auth Mfa Passkey Verify Post"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/auth/passkeys/authenticate/options":{"post":{"tags":["auth"],"summary":"Passkey Auth Options","description":"Generate a passwordless passkey authentication challenge.","operationId":"passkey_auth_options_auth_passkeys_authenticate_options_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasskeyAuthenticationStartRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Passkey Auth Options Auth Passkeys Authenticate Options Post"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/auth/passkeys/authenticate/verify":{"post":{"tags":["auth"],"summary":"Passkey Auth Verify","description":"Verify a passwordless passkey login response.","operationId":"passkey_auth_verify_auth_passkeys_authenticate_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasskeyAuthenticationFinishRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Passkey Auth Verify Auth Passkeys Authenticate Verify Post"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/billing/checkout":{"post":{"tags":["billing"],"summary":"Checkout","description":"Post checkout.","operationId":"checkout_billing_checkout_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CheckoutBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/docs":{"get":{"tags":["documents"],"summary":"List Docs","description":"Get root.","operationId":"list_docs_docs_get","parameters":[{"name":"scope","in":"query","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/DocumentScope"}],"default":"kb","title":"Scope"}},{"name":"chat_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Chat Id"}},{"name":"deal_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Deal Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"post":{"tags":["documents"],"summary":"Upload Doc","description":"Post root.","operationId":"upload_doc_docs_post","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_doc_docs_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/docs/kb-upload-requests":{"get":{"tags":["documents"],"summary":"List Kb Upload Requests","description":"Get kb upload requests.","operationId":"list_kb_upload_requests_docs_kb_upload_requests_get","parameters":[{"name":"mine","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Mine"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/docs/{document_id}/status":{"get":{"tags":["documents"],"summary":"Get Document Status","description":"Get {document id}/status.","operationId":"get_document_status_docs__document_id__status_get","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Document Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/docs/{doc_id}/access":{"post":{"tags":["documents"],"summary":"Set Access","description":"Post {doc id}/access.","operationId":"set_access_docs__doc_id__access_post","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Doc Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetAccessBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"get":{"tags":["documents"],"summary":"Get Access","description":"Get {doc id}/access.","operationId":"get_access_docs__doc_id__access_get","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Doc Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/docs/{doc_id}/promote":{"post":{"tags":["documents"],"summary":"Promote Doc","description":"Post {doc id}/promote.","operationId":"promote_doc_docs__doc_id__promote_post","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Doc Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/docs/{doc_id}":{"patch":{"tags":["documents"],"summary":"Update Doc","description":"Patch {doc id}.","operationId":"update_doc_docs__doc_id__patch","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Doc Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDocBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"delete":{"tags":["documents"],"summary":"Delete Doc","description":"Delete {doc id}.","operationId":"delete_doc_docs__doc_id__delete","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Doc Id"}},{"name":"hard","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Hard"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"deleted"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/docs/{doc_id}/download":{"get":{"tags":["documents"],"summary":"Download Doc","description":"Get {doc id}/download.","operationId":"download_doc_docs__doc_id__download_get","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Doc Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/docs/{doc_id}/view":{"get":{"tags":["documents"],"summary":"View Doc","description":"Get {doc id}/view.","operationId":"view_doc_docs__doc_id__view_get","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Doc Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/docs/{doc_id}/preview":{"get":{"tags":["documents"],"summary":"Preview Doc","description":"Get {doc id}/preview.","operationId":"preview_doc_docs__doc_id__preview_get","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Doc Id"}},{"name":"chunk_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Chunk Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/chat":{"post":{"tags":["chat"],"summary":"Ask","description":"Execute the primary chat query flow.","operationId":"ask_chat_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"answer":"string","answer_id":"00000000-0000-0000-0000-000000000001","confidence":1.0,"confidence_source":"string","confidence_threshold":1.0,"grounded":true,"grounding_status":"grounded","citations":[{"chunk_id":"string","excerpt":"string","score":1.0,"page":1,"doc_id":"string","doc_name":"string","document_name":"string","doc_url":"string","source_type":"string","source_label":"string","source_scope":"string","chunk_index":1,"section":"string"}],"can_answer":true,"warnings":["string"],"prompt_version":"string","mode":"string","output_type":"string","external_ready":true,"multi_step":true,"sub_queries":[{}],"structured_output":{},"answer_template":{},"follow_up_questions":["string"],"cache_hit":true,"stage_latency_ms":{"key":1.0}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/chat/citation-click":{"post":{"tags":["chat"],"summary":"Track Citation Click","description":"Record a user click on a returned citation.","operationId":"track_citation_click_chat_citation_click_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitationClickRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Track Citation Click Chat Citation Click Post"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/chat/feedback":{"post":{"tags":["chat"],"summary":"Submit Answer Feedback","description":"Store thumbs-up/down feedback for a generated answer.","operationId":"submit_answer_feedback_chat_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerFeedbackRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Submit Answer Feedback Chat Feedback Post"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/chats":{"get":{"tags":["chats"],"summary":"List Chats","description":"Get root.","operationId":"list_chats_chats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}},"post":{"tags":["chats"],"summary":"Create Chat","description":"Post root.","operationId":"create_chat_chats_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CreateChatBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/chats/{chat_id}":{"get":{"tags":["chats"],"summary":"Get Chat","description":"Get {chat id}.","operationId":"get_chat_chats__chat_id__get","parameters":[{"name":"chat_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Chat Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/query-activity":{"get":{"tags":["admin"],"summary":"List Query Activity","description":"Get query activity.","operationId":"list_query_activity_admin_query_activity_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mode"}},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/users":{"get":{"tags":["admin"],"summary":"List Users","description":"Get users.","operationId":"list_users_admin_users_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Page Size"}},{"name":"paginate","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Paginate"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"post":{"tags":["admin"],"summary":"Create User","description":"Post users.","operationId":"create_user_admin_users_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUserBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/policy":{"get":{"tags":["admin"],"summary":"Get Policy","description":"Return the current tenant policy and effective limits for the admin console.","operationId":"get_policy_admin_policy_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}},"patch":{"tags":["admin"],"summary":"Update Policy","description":"Update tenant policy controls such as SSO, retention, branding, and data residency.","operationId":"update_policy_admin_policy_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePolicyBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/workspace/onboarding-complete":{"post":{"tags":["admin"],"summary":"Mark Onboarding Complete","description":"Record that the admin has completed (or dismissed) the first-run onboarding wizard.\n\nThis persists the dismissal in the database so it survives a browser cache\nclear or a different device — not just in localStorage.\nRequires admin role.","operationId":"mark_onboarding_complete_admin_workspace_onboarding_complete_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/workspace/enterprise-checklist":{"get":{"tags":["admin"],"summary":"Enterprise Checklist","description":"Return the enterprise readiness checklist for this workspace.\n\nEach item has:\n id — stable identifier for frontend use\n label — human-readable item name\n status — \"done\" | \"pending\" | \"not_applicable\"\n detail — short explanation of the current state\n\nThe checklist is computed live from the current workspace state and is\nintended to be shown on the Admin Console overview page.\nRequires admin role.","operationId":"enterprise_checklist_admin_workspace_enterprise_checklist_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/industry-templates":{"get":{"tags":["admin"],"summary":"Industry Templates","description":"Get industry templates.","operationId":"industry_templates_admin_industry_templates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/apply-template":{"post":{"tags":["admin"],"summary":"Apply Template","description":"Post apply template.","operationId":"apply_template_admin_apply_template_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyIndustryTemplateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/knowledge-gaps":{"get":{"tags":["admin"],"summary":"Knowledge Gap Intelligence","description":"Get knowledge gaps.","operationId":"knowledge_gap_intelligence_admin_knowledge_gaps_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/knowledge-gaps/digest":{"post":{"tags":["admin"],"summary":"Send Knowledge Gap Digest","description":"Post knowledge gaps/digest.","operationId":"send_knowledge_gap_digest_admin_knowledge_gaps_digest_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/answer-templates":{"get":{"tags":["admin"],"summary":"List Answer Templates","description":"Get answer templates.","operationId":"list_answer_templates_admin_answer_templates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AnswerTemplateResponse"},"type":"array","title":"Response List Answer Templates Admin Answer Templates Get"},"examples":{"default":{"summary":"Example 200 response","value":[{"id":"00000000-0000-0000-0000-000000000001","name":"string","schema":{},"system_prompt_addition":"string","created_by":"00000000-0000-0000-0000-000000000001","created_at":"2026-03-09T12:00:00Z","updated_at":"2026-03-09T12:00:00Z"}]}}}}}}},"post":{"tags":["admin"],"summary":"Create Answer Template","description":"Post answer templates.","operationId":"create_answer_template_admin_answer_templates_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerTemplateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerTemplateResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"id":"00000000-0000-0000-0000-000000000001","name":"string","schema":{},"system_prompt_addition":"string","created_by":"00000000-0000-0000-0000-000000000001","created_at":"2026-03-09T12:00:00Z","updated_at":"2026-03-09T12:00:00Z"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/answer-templates/{template_id}":{"put":{"tags":["admin"],"summary":"Update Answer Template","description":"Put answer templates/{template id}.","operationId":"update_answer_template_admin_answer_templates__template_id__put","parameters":[{"name":"template_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Template Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerTemplateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerTemplateResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"id":"00000000-0000-0000-0000-000000000001","name":"string","schema":{},"system_prompt_addition":"string","created_by":"00000000-0000-0000-0000-000000000001","created_at":"2026-03-09T12:00:00Z","updated_at":"2026-03-09T12:00:00Z"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"delete":{"tags":["admin"],"summary":"Delete Answer Template","description":"Delete answer templates/{template id}.","operationId":"delete_answer_template_admin_answer_templates__template_id__delete","parameters":[{"name":"template_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Template Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"deleted"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/retrieval-training":{"get":{"tags":["admin"],"summary":"Retrieval Training Summary","description":"Get retrieval training.","operationId":"retrieval_training_summary_admin_retrieval_training_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/retrieval-training/export":{"get":{"tags":["admin"],"summary":"Export Retrieval Training","description":"Get retrieval training/export.","operationId":"export_retrieval_training_admin_retrieval_training_export_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/cache/purge":{"post":{"tags":["admin"],"summary":"Purge Response Cache","description":"Post cache/purge.","operationId":"purge_response_cache_admin_cache_purge_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/users/{user_id}/role":{"post":{"tags":["admin"],"summary":"Update Role","description":"Post users/{user id}/role.","operationId":"update_role_admin_users__user_id__role_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}},{"name":"role","in":"query","required":true,"schema":{"$ref":"#/components/schemas/Role"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/users/{user_id}":{"patch":{"tags":["admin"],"summary":"Update User","description":"Patch users/{user id}.","operationId":"update_user_admin_users__user_id__patch","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"delete":{"tags":["admin"],"summary":"Remove User","description":"Delete users/{user id}.","operationId":"remove_user_admin_users__user_id__delete","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"deleted"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/audit":{"get":{"tags":["admin"],"summary":"List Audit","description":"Return the most recent audit log entries for the tenant.","operationId":"list_audit_admin_audit_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/audit-log":{"get":{"tags":["admin"],"summary":"Search Audit Log","description":"Search audit log entries with filters, pagination, and verification status.","operationId":"search_audit_log_admin_audit_log_get","parameters":[{"name":"action","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action"}},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"}},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Search Audit Log Admin Audit Log Get"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/feedback":{"get":{"tags":["admin"],"summary":"List Answer Feedback","description":"Get feedback.","operationId":"list_answer_feedback_admin_feedback_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"rating","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rating"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/audit/export":{"get":{"tags":["admin"],"summary":"Export Audit","description":"Export recent audit entries in JSONL or CSV format.","operationId":"export_audit_admin_audit_export_get","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"jsonl","title":"Format"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":5000,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/audit-log/export":{"get":{"tags":["admin"],"summary":"Export Audit Log","description":"Export audit entries for a date range as JSON or CSV with chain verification metadata.","operationId":"export_audit_log_admin_audit_log_export_get","parameters":[{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Export Audit Log Admin Audit Log Export Get"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/audit-log/verify":{"get":{"tags":["admin"],"summary":"Verify Audit Log","description":"Verify the tenant audit hash chain and return the first broken link, if any.","operationId":"verify_audit_log_admin_audit_log_verify_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/consent-records":{"get":{"tags":["admin"],"summary":"List Consent Records","description":"Get consent records.","operationId":"list_consent_records_admin_consent_records_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/data-export":{"get":{"tags":["admin"],"summary":"Export Data","description":"Get data export.","operationId":"export_data_admin_data_export_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/invites":{"get":{"tags":["admin"],"summary":"List Invites","description":"Get invites.","operationId":"list_invites_admin_invites_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}},"post":{"tags":["admin"],"summary":"Create Invite","description":"Post invites.","operationId":"create_invite_admin_invites_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInviteBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/invites/{invite_id}/resend":{"post":{"tags":["admin"],"summary":"Resend Invite","description":"Post invites/{invite id}/resend.","operationId":"resend_invite_admin_invites__invite_id__resend_post","parameters":[{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","title":"Invite Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/invites/{invite_id}/revoke":{"post":{"tags":["admin"],"summary":"Revoke Invite","description":"Post invites/{invite id}/revoke.","operationId":"revoke_invite_admin_invites__invite_id__revoke_post","parameters":[{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","title":"Invite Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/notifications":{"get":{"tags":["admin"],"summary":"List Notifications","description":"Get notifications.","operationId":"list_notifications_admin_notifications_get","parameters":[{"name":"include_read","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Read"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/notifications/{notification_id}/read":{"post":{"tags":["admin"],"summary":"Mark Notification Read","description":"Post notifications/{notification id}/read.","operationId":"mark_notification_read_admin_notifications__notification_id__read_post","parameters":[{"name":"notification_id","in":"path","required":true,"schema":{"type":"string","title":"Notification Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/approvals":{"get":{"tags":["admin"],"summary":"List Approvals","description":"Get approvals.","operationId":"list_approvals_admin_approvals_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/approvals/{approval_id}/approve":{"post":{"tags":["admin"],"summary":"Approve Output","description":"Post approvals/{approval id}/approve.","operationId":"approve_output_admin_approvals__approval_id__approve_post","parameters":[{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","title":"Approval Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ApprovalReviewBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/approvals/{approval_id}/reject":{"post":{"tags":["admin"],"summary":"Reject Output","description":"Post approvals/{approval id}/reject.","operationId":"reject_output_admin_approvals__approval_id__reject_post","parameters":[{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","title":"Approval Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ApprovalReviewBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/kb-upload-requests":{"get":{"tags":["admin"],"summary":"List Kb Upload Requests","description":"Get kb upload requests.","operationId":"list_kb_upload_requests_admin_kb_upload_requests_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"requested_by","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requested By"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/kb-upload-requests/{request_id}/approve":{"post":{"tags":["admin"],"summary":"Approve Kb Upload Request","description":"Post kb upload requests/{request id}/approve.","operationId":"approve_kb_upload_request_admin_kb_upload_requests__request_id__approve_post","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/KbUploadApproveBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/kb-upload-requests/{request_id}/reject":{"post":{"tags":["admin"],"summary":"Reject Kb Upload Request","description":"Post kb upload requests/{request id}/reject.","operationId":"reject_kb_upload_request_admin_kb_upload_requests__request_id__reject_post","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/KbUploadRejectBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/usage/requests":{"get":{"tags":["admin"],"summary":"List Usage Requests","description":"Get usage/requests.","operationId":"list_usage_requests_admin_usage_requests_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/usage/requests/{request_id}/approve":{"post":{"tags":["admin"],"summary":"Approve Usage Request","description":"Post usage/requests/{request id}/approve.","operationId":"approve_usage_request_admin_usage_requests__request_id__approve_post","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/UsageRequestApproveBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/usage/requests/{request_id}/reject":{"post":{"tags":["admin"],"summary":"Reject Usage Request","description":"Post usage/requests/{request id}/reject.","operationId":"reject_usage_request_admin_usage_requests__request_id__reject_post","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/UsageRequestRejectBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/usage/grants":{"post":{"tags":["admin"],"summary":"Grant Usage Directly","description":"Post usage/grants.","operationId":"grant_usage_directly_admin_usage_grants_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantUsageBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/usage/balances":{"get":{"tags":["admin"],"summary":"List Usage Balances","description":"Get usage/balances.","operationId":"list_usage_balances_admin_usage_balances_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/directory/users":{"get":{"tags":["admin"],"summary":"List Directory Users","description":"Get directory/users.","operationId":"list_directory_users_admin_directory_users_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/directory/groups":{"get":{"tags":["admin"],"summary":"List Directory Groups","description":"Get directory/groups.","operationId":"list_directory_groups_admin_directory_groups_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/group-mappings":{"get":{"tags":["admin"],"summary":"List Group Mappings","description":"Get group mappings.","operationId":"list_group_mappings_admin_group_mappings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}},"post":{"tags":["admin"],"summary":"Create Group Mapping","description":"Post group mappings.","operationId":"create_group_mapping_admin_group_mappings_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateGroupMappingBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/group-mappings/{mapping_id}":{"patch":{"tags":["admin"],"summary":"Update Group Mapping","description":"Patch group mappings/{mapping id}.","operationId":"update_group_mapping_admin_group_mappings__mapping_id__patch","parameters":[{"name":"mapping_id","in":"path","required":true,"schema":{"type":"string","title":"Mapping Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateGroupMappingBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"delete":{"tags":["admin"],"summary":"Delete Group Mapping","description":"Delete group mappings/{mapping id}.","operationId":"delete_group_mapping_admin_group_mappings__mapping_id__delete","parameters":[{"name":"mapping_id","in":"path","required":true,"schema":{"type":"string","title":"Mapping Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"deleted"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/retention/purge":{"post":{"tags":["admin"],"summary":"Retention Purge","description":"Post retention/purge.","operationId":"retention_purge_admin_retention_purge_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/permissions":{"get":{"tags":["admin"],"summary":"List Available Permissions","description":"Get permissions.","operationId":"list_available_permissions_admin_permissions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/custom-roles":{"get":{"tags":["admin"],"summary":"List Custom Roles","description":"Get custom roles.","operationId":"list_custom_roles_admin_custom_roles_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}},"post":{"tags":["admin"],"summary":"Create Custom Role","description":"Post custom roles.","operationId":"create_custom_role_admin_custom_roles_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomRoleRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/custom-roles/{role_id}":{"patch":{"tags":["admin"],"summary":"Update Custom Role","description":"Patch custom roles/{role id}.","operationId":"update_custom_role_admin_custom_roles__role_id__patch","parameters":[{"name":"role_id","in":"path","required":true,"schema":{"type":"string","title":"Role Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomRoleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"delete":{"tags":["admin"],"summary":"Delete Custom Role","description":"Delete custom roles/{role id}.","operationId":"delete_custom_role_admin_custom_roles__role_id__delete","parameters":[{"name":"role_id","in":"path","required":true,"schema":{"type":"string","title":"Role Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"deleted"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/users/{user_id}/custom-role":{"post":{"tags":["admin"],"summary":"Assign Custom Role","description":"Post users/{user id}/custom role.","operationId":"assign_custom_role_admin_users__user_id__custom_role_post","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomRoleAssignmentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/sso-config":{"get":{"tags":["admin"],"summary":"Get Sso Config","description":"Get sso config.","operationId":"get_sso_config_admin_sso_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}},"put":{"tags":["admin"],"summary":"Upsert Sso Config","description":"Put sso config.","operationId":"upsert_sso_config_admin_sso_config_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SsoConfigRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/sso-config/test":{"post":{"tags":["admin"],"summary":"Test Sso Config","description":"Post sso config/test.","operationId":"test_sso_config_admin_sso_config_test_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/sso":{"get":{"tags":["admin"],"summary":"Get Sso Alias","description":"Get sso.","operationId":"get_sso_alias_admin_sso_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}},"put":{"tags":["admin"],"summary":"Update Sso Alias","description":"Put sso.","operationId":"update_sso_alias_admin_sso_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SsoAdminRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/sso/test":{"post":{"tags":["admin"],"summary":"Test Sso Alias","description":"Post sso/test.","operationId":"test_sso_alias_admin_sso_test_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/sso/status":{"get":{"tags":["admin"],"summary":"Sso Connection Status","description":"Get sso/status.","operationId":"sso_connection_status_admin_sso_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/admin/webhooks":{"get":{"tags":["admin"],"summary":"List Webhooks","description":"Get webhooks.","operationId":"list_webhooks_admin_webhooks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}},"post":{"tags":["admin"],"summary":"Create Webhook","description":"Post webhooks.","operationId":"create_webhook_admin_webhooks_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/webhooks/{endpoint_id}":{"patch":{"tags":["admin"],"summary":"Update Webhook","description":"Patch webhooks/{endpoint id}.","operationId":"update_webhook_admin_webhooks__endpoint_id__patch","parameters":[{"name":"endpoint_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Endpoint Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"delete":{"tags":["admin"],"summary":"Delete Webhook","description":"Delete webhooks/{endpoint id}.","operationId":"delete_webhook_admin_webhooks__endpoint_id__delete","parameters":[{"name":"endpoint_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Endpoint Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"deleted"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/admin/webhooks/deliveries":{"get":{"tags":["admin"],"summary":"List Webhook Deliveries","description":"Get webhooks/deliveries.","operationId":"list_webhook_deliveries_admin_webhooks_deliveries_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/usage":{"get":{"tags":["reports"],"summary":"Usage","description":"Get usage.","operationId":"usage_reports_usage_get","parameters":[{"name":"mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Set to \"sales\" to restrict the report to queries whose recorded mode is a sales mode (a mode starting with \"sales.\"). Omit for all modes.","title":"Mode"},"description":"Set to \"sales\" to restrict the report to queries whose recorded mode is a sales mode (a mode starting with \"sales.\"). Omit for all modes."},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/performance":{"get":{"tags":["reports"],"summary":"Performance","description":"Return tenant performance indicators for SLA dashboards and admin analytics.","operationId":"performance_reports_performance_get","parameters":[{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Performance Reports Performance Get"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/analytics/queries":{"get":{"tags":["reports"],"summary":"Query Analytics","description":"Return query volume, answer rate, and confidence trends for a tenant.","operationId":"query_analytics_reports_analytics_queries_get","parameters":[{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"30d","title":"Period"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Query Analytics Reports Analytics Queries Get"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/analytics/knowledge-gaps":{"get":{"tags":["reports"],"summary":"Knowledge Gap Analytics","description":"Return knowledge-gap trends and the most common unanswered topics.","operationId":"knowledge_gap_analytics_reports_analytics_knowledge_gaps_get","parameters":[{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"30d","title":"Period"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Knowledge Gap Analytics Reports Analytics Knowledge Gaps Get"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/analytics/documents":{"get":{"tags":["reports"],"summary":"Document Analytics","description":"Return document usage analytics, including cited and never-cited knowledge assets.","operationId":"document_analytics_reports_analytics_documents_get","parameters":[{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"30d","title":"Period"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Document Analytics Reports Analytics Documents Get"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/analytics/users":{"get":{"tags":["reports"],"summary":"User Analytics","description":"Return user engagement metrics and query-activity heatmap data.","operationId":"user_analytics_reports_analytics_users_get","parameters":[{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"30d","title":"Period"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response User Analytics Reports Analytics Users Get"},"examples":{"default":{"summary":"Example 200 response","value":{}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/gaps":{"get":{"tags":["reports"],"summary":"Gaps","description":"List unanswered questions.\n\nNever mode-scoped: knowledge-gap records carry no query mode, so `mode` is\naccepted but never applied and the response says so in `X-Vera-Mode-Scope`.","operationId":"gaps_reports_gaps_get","parameters":[{"name":"mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Accepted for symmetry with the query-activity reports but never applied: knowledge-gap records carry no query mode, so gap data cannot be scoped to a mode. Responses always carry X-Vera-Mode-Scope: all-modes.","title":"Mode"},"description":"Accepted for symmetry with the query-activity reports but never applied: knowledge-gap records carry no query mode, so gap data cannot be scoped to a mode. Responses always carry X-Vera-Mode-Scope: all-modes."},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/gaps-summary":{"get":{"tags":["reports"],"summary":"Gaps Summary","description":"Summarise unanswered questions.\n\nNever mode-scoped: knowledge-gap records carry no query mode, so `mode` is\naccepted but never applied and the response says so in `X-Vera-Mode-Scope`.","operationId":"gaps_summary_reports_gaps_summary_get","parameters":[{"name":"mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Accepted for symmetry with the query-activity reports but never applied: knowledge-gap records carry no query mode, so gap data cannot be scoped to a mode. Responses always carry X-Vera-Mode-Scope: all-modes.","title":"Mode"},"description":"Accepted for symmetry with the query-activity reports but never applied: knowledge-gap records carry no query mode, so gap data cannot be scoped to a mode. Responses always carry X-Vera-Mode-Scope: all-modes."},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/gaps-intelligence":{"get":{"tags":["reports"],"summary":"Gaps Intelligence","description":"Get gaps intelligence.","operationId":"gaps_intelligence_reports_gaps_intelligence_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/reports/sales-insights":{"get":{"tags":["reports"],"summary":"Sales Insights","description":"Report the sales-mode slice of the query ledger.\n\nEvery figure counts only queries whose recorded mode is a sales mode, so\n`total_sales_queries` agrees with the sales rows of `by_mode` on\n`/reports/usage`. `mode=sales` is accepted for symmetry with the other\nreports and is already the scope of this one.","operationId":"sales_insights_reports_sales_insights_get","parameters":[{"name":"mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Set to \"sales\" to restrict the report to queries whose recorded mode is a sales mode (a mode starting with \"sales.\"). Omit for all modes.","title":"Mode"},"description":"Set to \"sales\" to restrict the report to queries whose recorded mode is a sales mode (a mode starting with \"sales.\"). Omit for all modes."},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/deal-insights":{"get":{"tags":["reports"],"summary":"Deal Insights","description":"Get deal insights.","operationId":"deal_insights_reports_deal_insights_get","parameters":[{"name":"mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Set to \"sales\" to restrict the report to queries whose recorded mode is a sales mode (a mode starting with \"sales.\"). Omit for all modes.","title":"Mode"},"description":"Set to \"sales\" to restrict the report to queries whose recorded mode is a sales mode (a mode starting with \"sales.\"). Omit for all modes."},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/feedback":{"get":{"tags":["reports"],"summary":"Feedback Report","description":"Summarise answer feedback, optionally scoped to the mode of the query behind it.","operationId":"feedback_report_reports_feedback_get","parameters":[{"name":"mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Set to \"sales\" to restrict the report to queries whose recorded mode is a sales mode (a mode starting with \"sales.\"). Omit for all modes.","title":"Mode"},"description":"Set to \"sales\" to restrict the report to queries whose recorded mode is a sales mode (a mode starting with \"sales.\"). Omit for all modes."},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/usage.csv":{"get":{"tags":["reports"],"summary":"Usage Csv","description":"Get usage.csv.","operationId":"usage_csv_reports_usage_csv_get","parameters":[{"name":"mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Set to \"sales\" to restrict the report to queries whose recorded mode is a sales mode (a mode starting with \"sales.\"). Omit for all modes.","title":"Mode"},"description":"Set to \"sales\" to restrict the report to queries whose recorded mode is a sales mode (a mode starting with \"sales.\"). Omit for all modes."},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/gaps.csv":{"get":{"tags":["reports"],"summary":"Gaps Csv","description":"Export unanswered questions.\n\nNever mode-scoped: knowledge-gap records carry no query mode, so `mode` is\naccepted but never applied and the response says so in `X-Vera-Mode-Scope`.","operationId":"gaps_csv_reports_gaps_csv_get","parameters":[{"name":"mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Accepted for symmetry with the query-activity reports but never applied: knowledge-gap records carry no query mode, so gap data cannot be scoped to a mode. Responses always carry X-Vera-Mode-Scope: all-modes.","title":"Mode"},"description":"Accepted for symmetry with the query-activity reports but never applied: knowledge-gap records carry no query mode, so gap data cannot be scoped to a mode. Responses always carry X-Vera-Mode-Scope: all-modes."},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/sales-insights.csv":{"get":{"tags":["reports"],"summary":"Sales Insights Csv","description":"Export the sales topic breakdown over sales-mode queries only.","operationId":"sales_insights_csv_reports_sales_insights_csv_get","parameters":[{"name":"mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Set to \"sales\" to restrict the report to queries whose recorded mode is a sales mode (a mode starting with \"sales.\"). Omit for all modes.","title":"Mode"},"description":"Set to \"sales\" to restrict the report to queries whose recorded mode is a sales mode (a mode starting with \"sales.\"). Omit for all modes."},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/reports/deal-insights.csv":{"get":{"tags":["reports"],"summary":"Deal Insights Csv","description":"Get deal insights.csv.","operationId":"deal_insights_csv_reports_deal_insights_csv_get","parameters":[{"name":"mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Set to \"sales\" to restrict the report to queries whose recorded mode is a sales mode (a mode starting with \"sales.\"). Omit for all modes.","title":"Mode"},"description":"Set to \"sales\" to restrict the report to queries whose recorded mode is a sales mode (a mode starting with \"sales.\"). Omit for all modes."},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/integrations/{provider}/config":{"post":{"tags":["integrations"],"summary":"Configure Integration","description":"Post {provider}/config.","operationId":"configure_integration_integrations__provider__config_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/integrations":{"get":{"tags":["integrations"],"summary":"List Integrations","description":"Get root.","operationId":"list_integrations_integrations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/integrations/{provider}/launch":{"get":{"tags":["integrations"],"summary":"Launch Integration","description":"Get {provider}/launch.","operationId":"launch_integration_integrations__provider__launch_get","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/integrations/google_drive/configure-local":{"get":{"tags":["integrations"],"summary":"Configure Google Drive Local","description":"Get google drive/configure local.","operationId":"configure_google_drive_local_integrations_google_drive_configure_local_get","parameters":[{"name":"folder_id","in":"query","required":true,"schema":{"type":"string","title":"Folder Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/integrations/google_drive/sync-local":{"get":{"tags":["integrations"],"summary":"Sync Google Drive Local","description":"Get google drive/sync local.","operationId":"sync_google_drive_local_integrations_google_drive_sync_local_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/integrations/{provider}":{"get":{"tags":["integrations"],"summary":"Integration Detail","description":"Get {provider}.","operationId":"integration_detail_integrations__provider__get","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/integrations/{provider}/health":{"get":{"tags":["integrations"],"summary":"Integration Health","description":"Get {provider}/health.","operationId":"integration_health_integrations__provider__health_get","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/integrations/teams/setup-wizard":{"get":{"tags":["integrations"],"summary":"Teams Setup Wizard","description":"Get teams/setup wizard.","operationId":"teams_setup_wizard_integrations_teams_setup_wizard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/integrations/slack/events":{"post":{"tags":["integrations"],"summary":"Slack Events","description":"Post slack/events.","operationId":"slack_events_integrations_slack_events_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/integrations/slack/interactions":{"post":{"tags":["integrations"],"summary":"Slack Interactions","description":"Post slack/interactions.","operationId":"slack_interactions_integrations_slack_interactions_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/integrations/teams/bot/messages":{"post":{"tags":["integrations"],"summary":"Teams Bot Messages","description":"Post teams/bot/messages.","operationId":"teams_bot_messages_integrations_teams_bot_messages_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/integrations/teams/messages":{"post":{"tags":["integrations"],"summary":"Teams Messages","description":"Inbound endpoint for Teams *outgoing webhooks* (HMAC-signed by design).\n\nCB-11 note: this is intentionally distinct from `POST /teams/bot/messages`,\nwhich is the Bot Framework path and uses RS256 JWT validation against the\nBot Framework JWKS (see `_teams_bot_bearer_valid`). Microsoft's outgoing\nwebhook feature uses an HMAC-SHA256 over `v1::` signed with a\nper-channel shared secret. Both routes are kept because they serve\ndifferent Teams admin features; do not consolidate without admin signoff.","operationId":"teams_messages_integrations_teams_messages_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/integrations/zoom/webhook":{"post":{"tags":["integrations"],"summary":"Zoom Webhook","description":"Post zoom/webhook.","operationId":"zoom_webhook_integrations_zoom_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/integrations/{provider}/connect":{"post":{"tags":["integrations"],"summary":"Connect Integration","description":"Post {provider}/connect.","operationId":"connect_integration_integrations__provider__connect_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/IntegrationConnectIn"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/integrations/{provider}/callback":{"get":{"tags":["integrations"],"summary":"Integration Callback","description":"Get {provider}/callback.","operationId":"integration_callback_integrations__provider__callback_get","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}},{"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"}},{"name":"error","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},{"name":"error_description","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Description"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/integrations/{provider}/sync":{"post":{"tags":["integrations"],"summary":"Sync Integration","description":"Post {provider}/sync.","operationId":"sync_integration_integrations__provider__sync_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/integrations/google_drive/webhook":{"post":{"tags":["integrations"],"summary":"Google Drive Webhook","description":"Post google drive/webhook.","operationId":"google_drive_webhook_integrations_google_drive_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/integrations/sharepoint/webhook":{"get":{"tags":["integrations"],"summary":"Sharepoint Webhook Validation","description":"Get sharepoint/webhook.","operationId":"sharepoint_webhook_validation_integrations_sharepoint_webhook_get","parameters":[{"name":"validationToken","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Validationtoken"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"post":{"tags":["integrations"],"summary":"Sharepoint Webhook","description":"Post sharepoint/webhook.","operationId":"sharepoint_webhook_integrations_sharepoint_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/integrations/{provider}/disconnect":{"post":{"tags":["integrations"],"summary":"Disconnect Integration","description":"Post {provider}/disconnect.","operationId":"disconnect_integration_integrations__provider__disconnect_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/deals":{"get":{"tags":["deals"],"summary":"List Deals","description":"Get root.","operationId":"list_deals_deals_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}},"post":{"tags":["deals"],"summary":"Create Deal","description":"Post root.","operationId":"create_deal_deals_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDealBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/deals/{deal_id}":{"get":{"tags":["deals"],"summary":"Get Deal","description":"Get {deal id}.","operationId":"get_deal_deals__deal_id__get","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deal Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"patch":{"tags":["deals"],"summary":"Update Deal","description":"Patch {deal id}.","operationId":"update_deal_deals__deal_id__patch","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deal Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDealBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/deals/{deal_id}/artifacts":{"get":{"tags":["deals"],"summary":"List Artifacts","description":"Get {deal id}/artifacts.","operationId":"list_artifacts_deals__deal_id__artifacts_get","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deal Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"post":{"tags":["deals"],"summary":"Create Artifact","description":"Post {deal id}/artifacts.","operationId":"create_artifact_deals__deal_id__artifacts_post","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deal Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateArtifactBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/deals/{deal_id}/artifacts/upload":{"post":{"tags":["deals"],"summary":"Upload Artifact","description":"Post {deal id}/artifacts/upload.","operationId":"upload_artifact_deals__deal_id__artifacts_upload_post","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deal Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_artifact_deals__deal_id__artifacts_upload_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/deals/{deal_id}/transcripts":{"get":{"tags":["deals"],"summary":"List Transcripts","description":"Get {deal id}/transcripts.","operationId":"list_transcripts_deals__deal_id__transcripts_get","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deal Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"post":{"tags":["deals"],"summary":"Create Transcript","description":"Post {deal id}/transcripts.","operationId":"create_transcript_deals__deal_id__transcripts_post","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deal Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTranscriptBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/deals/{deal_id}/transcripts/upload":{"post":{"tags":["deals"],"summary":"Upload Transcript","description":"Post {deal id}/transcripts/upload.","operationId":"upload_transcript_deals__deal_id__transcripts_upload_post","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deal Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_transcript_deals__deal_id__transcripts_upload_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/deals/{deal_id}/artifacts/{artifact_id}":{"delete":{"tags":["deals"],"summary":"Delete Artifact","description":"Delete {deal id}/artifacts/{artifact id}.","operationId":"delete_artifact_deals__deal_id__artifacts__artifact_id__delete","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deal Id"}},{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Artifact Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"deleted"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/deals/{deal_id}/transcripts/{transcript_id}":{"delete":{"tags":["deals"],"summary":"Delete Transcript","description":"Delete {deal id}/transcripts/{transcript id}.","operationId":"delete_transcript_deals__deal_id__transcripts__transcript_id__delete","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deal Id"}},{"name":"transcript_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Transcript Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"deleted"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/deals/{deal_id}/chats":{"get":{"tags":["deals"],"summary":"List Deal Chats","description":"Get {deal id}/chats.","operationId":"list_deal_chats_deals__deal_id__chats_get","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deal Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/deals/{deal_id}/members":{"get":{"tags":["deals"],"summary":"List Deal Members","description":"Get {deal id}/members.","operationId":"list_deal_members_deals__deal_id__members_get","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deal Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"post":{"tags":["deals"],"summary":"Add Deal Member","description":"Post {deal id}/members.","operationId":"add_deal_member_deals__deal_id__members_post","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deal Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddDealMemberBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/deals/{deal_id}/members/{member_id}":{"delete":{"tags":["deals"],"summary":"Remove Deal Member","description":"Delete {deal id}/members/{member id}.","operationId":"remove_deal_member_deals__deal_id__members__member_id__delete","parameters":[{"name":"deal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Deal Id"}},{"name":"member_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Member Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"deleted"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/workos/webhook":{"post":{"tags":["workos"],"summary":"Workos Webhook","description":"Post webhook.","operationId":"workos_webhook_workos_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/scim/v2/Users":{"get":{"tags":["scim"],"summary":"List Users","description":"Get Users.","operationId":"list_users_scim_v2_Users_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}},"post":{"tags":["scim"],"summary":"Create User","description":"Post Users.","operationId":"create_user_scim_v2_Users_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScimUserCreateBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/scim/v2/Users/{user_id}":{"get":{"tags":["scim"],"summary":"Get User","description":"Get Users/{user id}.","operationId":"get_user_scim_v2_Users__user_id__get","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"patch":{"tags":["scim"],"summary":"Update User","description":"Patch Users/{user id}.","operationId":"update_user_scim_v2_Users__user_id__patch","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScimUserUpdateBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"delete":{"tags":["scim"],"summary":"Delete User","description":"Delete Users/{user id}.","operationId":"delete_user_scim_v2_Users__user_id__delete","parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","title":"User Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"deleted"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/scim/v2/Groups":{"get":{"tags":["scim"],"summary":"List Groups","description":"Get Groups.","operationId":"list_groups_scim_v2_Groups_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}},"post":{"tags":["scim"],"summary":"Create Group","description":"Post Groups.","operationId":"create_group_scim_v2_Groups_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScimGroupCreateBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/scim/v2/Groups/{group_id}":{"get":{"tags":["scim"],"summary":"Get Group","description":"Get Groups/{group id}.","operationId":"get_group_scim_v2_Groups__group_id__get","parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"patch":{"tags":["scim"],"summary":"Update Group","description":"Patch Groups/{group id}.","operationId":"update_group_scim_v2_Groups__group_id__patch","parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScimGroupUpdateBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"delete":{"tags":["scim"],"summary":"Delete Group","description":"Delete Groups/{group id}.","operationId":"delete_group_scim_v2_Groups__group_id__delete","parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"deleted"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/usage/summary":{"get":{"tags":["usage"],"summary":"Usage Summary","description":"Get summary.","operationId":"usage_summary_usage_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/usage/requests":{"get":{"tags":["usage"],"summary":"List My Usage Requests","description":"Get requests.","operationId":"list_my_usage_requests_usage_requests_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"post":{"tags":["usage"],"summary":"Create Usage Request","description":"Post requests.","operationId":"create_usage_request_usage_requests_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUsageRequestBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/overview":{"get":{"tags":["platform-admin"],"summary":"Overview","description":"Get overview.","operationId":"overview_platform_admin_overview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/platform-admin/notifications":{"get":{"tags":["platform-admin"],"summary":"List Notifications","description":"Get notifications.","operationId":"list_notifications_platform_admin_notifications_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/notifications/{notification_id}/ack":{"post":{"tags":["platform-admin"],"summary":"Acknowledge Notification","description":"Post notifications/{notification id}/ack.","operationId":"acknowledge_notification_platform_admin_notifications__notification_id__ack_post","parameters":[{"name":"notification_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Notification Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/notifications/{notification_id}/resolve":{"post":{"tags":["platform-admin"],"summary":"Resolve Notification","description":"Post notifications/{notification id}/resolve.","operationId":"resolve_notification_platform_admin_notifications__notification_id__resolve_post","parameters":[{"name":"notification_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Notification Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ResolveNotificationBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/tenants":{"get":{"tags":["platform-admin"],"summary":"List Tenants","description":"Get tenants.","operationId":"list_tenants_platform_admin_tenants_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"post":{"tags":["platform-admin"],"summary":"Create Tenant","description":"Post tenants.","operationId":"create_tenant_platform_admin_tenants_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTenantBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/tenants/{org_id}":{"get":{"tags":["platform-admin"],"summary":"Tenant Detail","description":"Get tenants/{org id}.","operationId":"tenant_detail_platform_admin_tenants__org_id__get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/tenants/{org_id}/users":{"post":{"tags":["platform-admin"],"summary":"Add Tenant User","description":"Post tenants/{org id}/users.","operationId":"add_tenant_user_platform_admin_tenants__org_id__users_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddTenantUserBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/tenants/{org_id}/switch":{"post":{"tags":["platform-admin"],"summary":"Switch Tenant","description":"Post tenants/{org id}/switch.","operationId":"switch_tenant_platform_admin_tenants__org_id__switch_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/pricing/plans":{"get":{"tags":["platform-admin"],"summary":"List Pricing Plans","description":"Get pricing/plans.","operationId":"list_pricing_plans_platform_admin_pricing_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/platform-admin/pricing/plans/{plan_code}":{"patch":{"tags":["platform-admin"],"summary":"Update Pricing Plan","description":"Patch pricing/plans/{plan code}.","operationId":"update_pricing_plan_platform_admin_pricing_plans__plan_code__patch","parameters":[{"name":"plan_code","in":"path","required":true,"schema":{"type":"string","title":"Plan Code"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePricingPlanBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/tenants/{org_id}/pricing":{"get":{"tags":["platform-admin"],"summary":"Tenant Pricing Projection","description":"Get tenants/{org id}/pricing.","operationId":"tenant_pricing_projection_platform_admin_tenants__org_id__pricing_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/tenants/{org_id}/plan-lifecycle":{"get":{"tags":["platform-admin"],"summary":"Tenant Plan Lifecycle","description":"Get tenants/{org id}/plan lifecycle.","operationId":"tenant_plan_lifecycle_platform_admin_tenants__org_id__plan_lifecycle_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"post":{"tags":["platform-admin"],"summary":"Tenant Plan Lifecycle Update","description":"Post tenants/{org id}/plan lifecycle.","operationId":"tenant_plan_lifecycle_update_platform_admin_tenants__org_id__plan_lifecycle_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantPlanLifecycleBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/tenants/{org_id}/connector-cap":{"patch":{"tags":["platform-admin"],"summary":"Tenant Connector Cap Update","description":"Set or clear a tenant's connector cap override (MKT-1, PR d).\n\nPlatform-admin only: the cap is what the order sells, so a tenant admin\ncan't raise it through ``PATCH /admin/policy``.","operationId":"tenant_connector_cap_update_platform_admin_tenants__org_id__connector_cap_patch","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantConnectorCapBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/billing/preview":{"get":{"tags":["platform-admin"],"summary":"Billing Preview","description":"Get billing/preview.","operationId":"billing_preview_platform_admin_billing_preview_get","parameters":[{"name":"month","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Month"}},{"name":"org_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/billing/runs":{"post":{"tags":["platform-admin"],"summary":"Billing Run Generate","description":"Post billing/runs.","operationId":"billing_run_generate_platform_admin_billing_runs_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/BillingRunGenerateBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}},"get":{"tags":["platform-admin"],"summary":"Billing Runs","description":"Get billing/runs.","operationId":"billing_runs_platform_admin_billing_runs_get","parameters":[{"name":"month","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Month"}},{"name":"org_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Org Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/billing/runs/{run_id}":{"get":{"tags":["platform-admin"],"summary":"Billing Run Detail","description":"Get billing/runs/{run id}.","operationId":"billing_run_detail_platform_admin_billing_runs__run_id__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/billing/runs/{run_id}/export":{"get":{"tags":["platform-admin"],"summary":"Billing Run Export","description":"Get billing/runs/{run id}/export.","operationId":"billing_run_export_platform_admin_billing_runs__run_id__export_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"csv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/billing/customers":{"get":{"tags":["platform-admin"],"summary":"Billing Customers","description":"Get billing/customers.","operationId":"billing_customers_platform_admin_billing_customers_get","parameters":[{"name":"processor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Processor"}},{"name":"org_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Org Id"}},{"name":"include_inactive","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Inactive"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/billing/customers/{org_id}":{"put":{"tags":["platform-admin"],"summary":"Billing Customer Upsert","description":"Put billing/customers/{org id}.","operationId":"billing_customer_upsert_platform_admin_billing_customers__org_id__put","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingCustomerUpsertBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/billing/runs/{run_id}/sync":{"post":{"tags":["platform-admin"],"summary":"Billing Run Sync","description":"Post billing/runs/{run id}/sync.","operationId":"billing_run_sync_platform_admin_billing_runs__run_id__sync_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/BillingRunSyncBody"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/platform-admin/billing/webhooks/stripe":{"post":{"tags":["platform-admin"],"summary":"Billing Stripe Webhook","description":"Post billing/webhooks/stripe.","operationId":"billing_stripe_webhook_platform_admin_billing_webhooks_stripe_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}}},"/platform-admin/billing/export":{"get":{"tags":["platform-admin"],"summary":"Billing Export","description":"Get billing/export.","operationId":"billing_export_platform_admin_billing_export_get","parameters":[{"name":"month","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Month"}},{"name":"org_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Org Id"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"csv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/signup":{"post":{"tags":["signup"],"summary":"Self Serve Signup","description":"Post signup.","operationId":"self_serve_signup_signup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/signup/resend-verification":{"post":{"tags":["signup"],"summary":"Resend Signup Verification","description":"Post signup/resend verification.","operationId":"resend_signup_verification_signup_resend_verification_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/SignupResendRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/signup/verify":{"post":{"tags":["signup"],"summary":"Verify Signup Email","description":"Post signup/verify.","operationId":"verify_signup_email_signup_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/api-keys":{"get":{"tags":["api-keys"],"summary":"List Api Keys","description":"Get root.","operationId":"list_api_keys_api_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}}}},"post":{"tags":["api-keys"],"summary":"Create Api Key","description":"Post root.","operationId":"create_api_key_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyCreateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/api-keys/{api_key_id}":{"delete":{"tags":["api-keys"],"summary":"Revoke Api Key","description":"Delete {api key id}.","operationId":"revoke_api_key_api_keys__api_key_id__delete","parameters":[{"name":"api_key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Api Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"deleted"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}},"/api-keys/{api_key_id}/rotate":{"post":{"tags":["api-keys"],"summary":"Rotate Api Key","description":"Post {api key id}/rotate.","operationId":"rotate_api_key_api_keys__api_key_id__rotate_post","parameters":[{"name":"api_key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Api Key Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyRotateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAPIAnyResponse"},"examples":{"default":{"summary":"Example 200 response","value":{"status":"ok"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"},"examples":{"default":{"summary":"Example 422 response","value":{"detail":[{"loc":["string"],"msg":"string","type":"string","input":"","ctx":{}}]}}}}}}}}}},"components":{"schemas":{"APIKeyCreateRequest":{"properties":{"name":{"type":"string","maxLength":200,"title":"Name"},"scopes":{"type":"string","maxLength":200,"title":"Scopes","default":"read"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["name"],"title":"APIKeyCreateRequest"},"APIKeyRotateRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Name"},"scopes":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Scopes"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","title":"APIKeyRotateRequest"},"AddDealMemberBody":{"properties":{"email":{"type":"string","maxLength":320,"minLength":1,"title":"Email"},"role":{"allOf":[{"$ref":"#/components/schemas/DealMemberRole"}],"default":"member"}},"type":"object","required":["email"],"title":"AddDealMemberBody"},"AddTenantUserBody":{"properties":{"email":{"type":"string","maxLength":320,"minLength":1,"title":"Email"},"name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Name"},"role":{"allOf":[{"$ref":"#/components/schemas/Role"}],"default":"member"}},"type":"object","required":["email"],"title":"AddTenantUserBody"},"AnswerFeedbackRequest":{"properties":{"answer_id":{"type":"string","format":"uuid","title":"Answer Id"},"rating":{"type":"string","enum":["up","down"],"title":"Rating"},"comment":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Comment"}},"type":"object","required":["answer_id","rating"],"title":"AnswerFeedbackRequest"},"AnswerTemplateRequest":{"properties":{"name":{"type":"string","title":"Name"},"schema":{"type":"object","title":"Schema"},"system_prompt_addition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"System Prompt Addition"}},"type":"object","required":["name","schema"],"title":"AnswerTemplateRequest"},"AnswerTemplateResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"schema":{"type":"object","title":"Schema"},"system_prompt_addition":{"type":"string","title":"System Prompt Addition"},"created_by":{"type":"string","format":"uuid","title":"Created By"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","schema","system_prompt_addition","created_by","created_at","updated_at"],"title":"AnswerTemplateResponse"},"ApplyIndustryTemplateRequest":{"properties":{"template_key":{"type":"string","title":"Template Key"},"confirm_overwrite":{"type":"boolean","title":"Confirm Overwrite","default":false}},"type":"object","required":["template_key"],"title":"ApplyIndustryTemplateRequest"},"ApprovalReviewBody":{"properties":{"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"},"tag":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Tag"},"reference_link":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Reference Link"}},"type":"object","title":"ApprovalReviewBody"},"AuthSessionFeaturesResponse":{"properties":{"web_search":{"type":"boolean","title":"Web Search","default":false}},"type":"object","title":"AuthSessionFeaturesResponse","description":"Deployment-level capabilities the workspace UI should expose.\n\nSUPPORT-108: distinct from `policy`, which is per-tenant configuration held\nin the database. These are server-side switches (env/config) the client\ncannot infer, so it must not render controls that depend on them."},"AuthSessionOrgResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"onboarding_completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Onboarding Completed At"}},"type":"object","required":["id","name","slug"],"title":"AuthSessionOrgResponse"},"AuthSessionPolicyResponse":{"properties":{"require_sso":{"type":"boolean","title":"Require Sso"},"require_mfa":{"type":"boolean","title":"Require Mfa"},"session_ttl_hours":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Session Ttl Hours"},"group_sync_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group Sync Mode"},"chat_retention_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Chat Retention Days"},"document_retention_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Document Retention Days"},"directory_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Directory Id"},"data_region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Region"},"ip_allowlist":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Allowlist"},"custom_logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Logo Url"},"custom_primary_color":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Primary Color"},"custom_support_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Support Email"}},"type":"object","required":["require_sso","require_mfa"],"title":"AuthSessionPolicyResponse"},"AuthSessionResponse":{"properties":{"user":{"$ref":"#/components/schemas/AuthSessionUserResponse"},"org":{"$ref":"#/components/schemas/AuthSessionOrgResponse"},"role":{"type":"string","title":"Role"},"custom_role":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Custom Role"},"platform_admin":{"type":"boolean","title":"Platform Admin"},"policy":{"$ref":"#/components/schemas/AuthSessionPolicyResponse"},"features":{"$ref":"#/components/schemas/AuthSessionFeaturesResponse"}},"type":"object","required":["user","org","role","platform_admin","policy"],"title":"AuthSessionResponse"},"AuthSessionUserResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"mfa_enabled":{"type":"boolean","title":"Mfa Enabled"},"mfa_recovery_codes_remaining":{"type":"integer","title":"Mfa Recovery Codes Remaining"},"email_verification_required":{"type":"boolean","title":"Email Verification Required","default":false},"email_verified_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Verified At"}},"type":"object","required":["id","email","mfa_enabled","mfa_recovery_codes_remaining"],"title":"AuthSessionUserResponse"},"BillingCustomerUpsertBody":{"properties":{"processor":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Processor"},"customer_reference":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Customer Reference"},"billing_email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Billing Email"},"is_active":{"type":"boolean","title":"Is Active","default":true},"meta":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Meta"}},"type":"object","title":"BillingCustomerUpsertBody"},"BillingRunGenerateBody":{"properties":{"month":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Month"},"processor":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Processor"},"processor_reference":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Processor Reference"},"org_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Org Id"}},"type":"object","title":"BillingRunGenerateBody"},"BillingRunSyncBody":{"properties":{"processor":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Processor"},"dry_run":{"type":"boolean","title":"Dry Run","default":false}},"type":"object","title":"BillingRunSyncBody"},"Body_upload_artifact_deals__deal_id__artifacts_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"artifact_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Artifact Type"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"}},"type":"object","required":["file"],"title":"Body_upload_artifact_deals__deal_id__artifacts_upload_post"},"Body_upload_doc_docs_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"scope":{"allOf":[{"$ref":"#/components/schemas/DocumentScope"}],"default":"kb"},"chat_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chat Id"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"}},"type":"object","required":["file"],"title":"Body_upload_doc_docs_post"},"Body_upload_transcript_deals__deal_id__transcripts_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"}},"type":"object","required":["file"],"title":"Body_upload_transcript_deals__deal_id__transcripts_upload_post"},"ChatRequest":{"properties":{"question":{"type":"string","maxLength":20000,"title":"Question"},"chat_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Chat Id"},"mode":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Mode"},"output_type":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Output Type"},"external_ready":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"External Ready"},"answer_template_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Answer Template Id"},"live_connectors":{"items":{"type":"string"},"type":"array","maxItems":50,"title":"Live Connectors","default":[]},"web_search_enabled":{"type":"boolean","title":"Web Search Enabled","default":false},"stream":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Stream","default":false}},"type":"object","required":["question"],"title":"ChatRequest"},"ChatResponse":{"properties":{"answer":{"type":"string","title":"Answer"},"answer_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Answer Id"},"confidence":{"type":"number","title":"Confidence"},"confidence_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence Source"},"confidence_threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Threshold"},"grounded":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Grounded"},"grounding_status":{"anyOf":[{"type":"string","enum":["grounded","partial","ungrounded","no_evidence"]},{"type":"null"}],"title":"Grounding Status"},"citations":{"items":{"$ref":"#/components/schemas/CitationOut"},"type":"array","title":"Citations"},"can_answer":{"type":"boolean","title":"Can Answer"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings","default":[]},"prompt_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Version"},"mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mode"},"output_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Output Type"},"external_ready":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"External Ready"},"multi_step":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Multi Step","default":false},"sub_queries":{"items":{"type":"object"},"type":"array","title":"Sub Queries","default":[]},"structured_output":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Structured Output"},"answer_template":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Answer Template"},"follow_up_questions":{"items":{"type":"string"},"type":"array","title":"Follow Up Questions","default":[]},"cache_hit":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Cache Hit","default":false},"stage_latency_ms":{"additionalProperties":{"type":"number"},"type":"object","title":"Stage Latency Ms","default":{}}},"type":"object","required":["answer","confidence","citations","can_answer"],"title":"ChatResponse"},"CheckoutBody":{"properties":{"plan_code":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Plan Code"},"billing_interval":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Billing Interval"},"success_url":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Success Url"},"cancel_url":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Cancel Url"}},"type":"object","title":"CheckoutBody"},"CitationClickRequest":{"properties":{"query_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Query Id"},"answer_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Answer Id"},"chunk_id":{"type":"string","format":"uuid","title":"Chunk Id"},"document_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Document Id"},"rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank"}},"type":"object","required":["chunk_id"],"title":"CitationClickRequest"},"CitationOut":{"properties":{"chunk_id":{"type":"string","title":"Chunk Id"},"excerpt":{"type":"string","title":"Excerpt"},"score":{"type":"number","title":"Score"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page"},"doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Id"},"doc_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Name"},"document_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Name"},"doc_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Url"},"source_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Type"},"source_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Label"},"source_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Scope"},"chunk_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Chunk Index"},"section":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Section"}},"type":"object","required":["chunk_id","excerpt","score","page"],"title":"CitationOut"},"CreateArtifactBody":{"properties":{"name":{"type":"string","maxLength":300,"minLength":1,"title":"Name"},"artifact_type":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Artifact Type"},"status":{"type":"string","maxLength":50,"title":"Status","default":"pending"},"source":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Source"},"source_ref":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Source Ref"}},"type":"object","required":["name"],"title":"CreateArtifactBody"},"CreateChatBody":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Title"},"mode":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Mode"},"deal_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Deal Id"}},"type":"object","title":"CreateChatBody"},"CreateDealBody":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"account_name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Account Name"},"stage":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Stage"},"owner":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Owner"},"notes":{"anyOf":[{"type":"string","maxLength":20000},{"type":"null"}],"title":"Notes"}},"type":"object","required":["name"],"title":"CreateDealBody"},"CreateGroupMappingBody":{"properties":{"group_name":{"type":"string","maxLength":300,"minLength":1,"title":"Group Name"},"group_external_id":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Group External Id"},"role":{"allOf":[{"$ref":"#/components/schemas/Role"}],"default":"member"}},"type":"object","required":["group_name"],"title":"CreateGroupMappingBody"},"CreateInviteBody":{"properties":{"email":{"type":"string","maxLength":320,"minLength":1,"title":"Email"},"role":{"allOf":[{"$ref":"#/components/schemas/Role"}],"default":"member"}},"type":"object","required":["email"],"title":"CreateInviteBody"},"CreateTenantBody":{"properties":{"name":{"type":"string","maxLength":300,"minLength":1,"title":"Name"},"usage_plan":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Usage Plan"},"slug":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Slug"},"external_id":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"External Id"},"admin_email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Admin Email"},"admin_name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Admin Name"}},"type":"object","required":["name"],"title":"CreateTenantBody"},"CreateTranscriptBody":{"properties":{"name":{"type":"string","maxLength":300,"minLength":1,"title":"Name"},"status":{"type":"string","maxLength":50,"title":"Status","default":"pending"},"source":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Source"},"source_ref":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Source Ref"}},"type":"object","required":["name"],"title":"CreateTranscriptBody"},"CreateUsageRequestBody":{"properties":{"amount_eur":{"type":"integer","title":"Amount Eur"},"reason":{"type":"string","maxLength":2000,"title":"Reason","default":""}},"type":"object","required":["amount_eur"],"title":"CreateUsageRequestBody"},"CreateUserBody":{"properties":{"email":{"type":"string","maxLength":320,"minLength":1,"title":"Email"},"name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Name"},"role":{"allOf":[{"$ref":"#/components/schemas/Role"}],"default":"member"}},"type":"object","required":["email"],"title":"CreateUserBody"},"CustomRoleAssignmentRequest":{"properties":{"custom_role_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Custom Role Id"}},"type":"object","title":"CustomRoleAssignmentRequest"},"CustomRoleRequest":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"permissions":{"items":{"type":"string"},"type":"array","title":"Permissions"}},"type":"object","required":["name","permissions"],"title":"CustomRoleRequest"},"DealMemberRole":{"type":"string","enum":["owner","member","viewer"],"title":"DealMemberRole"},"DocumentScope":{"type":"string","enum":["kb","chat","deal"],"title":"DocumentScope"},"GrantUsageBody":{"properties":{"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"amount_eur":{"type":"integer","title":"Amount Eur"},"reason":{"type":"string","maxLength":2000,"title":"Reason","default":""}},"type":"object","required":["amount_eur"],"title":"GrantUsageBody"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"HealthResponse"},"IntegrationConnectIn":{"properties":{"return_to":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Return To"}},"type":"object","title":"IntegrationConnectIn","description":"Optional body for ``POST /{provider}/connect`` — only ``return_to`` is read."},"KbUploadApproveBody":{"properties":{"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"},"filename":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Filename"},"tags":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Tags"}},"type":"object","title":"KbUploadApproveBody"},"KbUploadRejectBody":{"properties":{"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"}},"type":"object","title":"KbUploadRejectBody"},"MFACodeRequest":{"properties":{"code":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Code"},"recovery_code":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Recovery Code"}},"type":"object","title":"MFACodeRequest"},"MFAEnableRequest":{"properties":{"setup_token":{"type":"string","maxLength":2000,"title":"Setup Token"},"code":{"type":"string","maxLength":64,"title":"Code"}},"type":"object","required":["setup_token","code"],"title":"MFAEnableRequest"},"MFAPasskeyRequest":{"properties":{"challenge_token":{"type":"string","maxLength":2000,"title":"Challenge Token"}},"type":"object","required":["challenge_token"],"title":"MFAPasskeyRequest"},"MFAPasskeyVerifyRequest":{"properties":{"challenge_token":{"type":"string","maxLength":2000,"title":"Challenge Token"},"token":{"type":"string","maxLength":2000,"title":"Token"},"credential":{"type":"object","title":"Credential"}},"type":"object","required":["challenge_token","token","credential"],"title":"MFAPasskeyVerifyRequest"},"MFAVerifyChallengeRequest":{"properties":{"challenge_token":{"type":"string","maxLength":2000,"title":"Challenge Token"},"code":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Code"},"recovery_code":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Recovery Code"}},"type":"object","required":["challenge_token"],"title":"MFAVerifyChallengeRequest"},"OpenAPIAnyResponse":{"title":"OpenAPIAnyResponse","description":"Permissive fallback schema for dynamically shaped JSON payloads."},"OrganizationMembershipResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"role":{"type":"string","title":"Role"},"custom_role_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Role Name"},"is_active":{"type":"boolean","title":"Is Active"}},"type":"object","required":["id","name","slug","role","is_active"],"title":"OrganizationMembershipResponse"},"PasskeyAuthenticationFinishRequest":{"properties":{"token":{"type":"string","maxLength":2000,"title":"Token"},"credential":{"type":"object","title":"Credential"}},"type":"object","required":["token","credential"],"title":"PasskeyAuthenticationFinishRequest"},"PasskeyAuthenticationStartRequest":{"properties":{"email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Email"}},"type":"object","title":"PasskeyAuthenticationStartRequest"},"PasskeyRegistrationFinishRequest":{"properties":{"token":{"type":"string","maxLength":2000,"title":"Token"},"credential":{"type":"object","title":"Credential"},"label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Label"}},"type":"object","required":["token","credential"],"title":"PasskeyRegistrationFinishRequest"},"ReadyResponse":{"properties":{"database":{"type":"string","title":"Database"},"redis":{"type":"string","title":"Redis"}},"type":"object","required":["database","redis"],"title":"ReadyResponse"},"ResolveNotificationBody":{"properties":{"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"}},"type":"object","title":"ResolveNotificationBody"},"Role":{"type":"string","enum":["admin","member","viewer"],"title":"Role"},"ScimGroupCreateBody":{"properties":{"externalId":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Externalid"},"id":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Id"},"displayName":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Displayname"},"name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Name"}},"type":"object","title":"ScimGroupCreateBody"},"ScimGroupUpdateBody":{"properties":{"displayName":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Displayname"},"members":{"anyOf":[{"items":{"$ref":"#/components/schemas/ScimMember"},"type":"array"},{"type":"null"}],"title":"Members"}},"type":"object","title":"ScimGroupUpdateBody"},"ScimMember":{"properties":{"value":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Value"}},"type":"object","title":"ScimMember"},"ScimName":{"properties":{"formatted":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Formatted"}},"type":"object","title":"ScimName"},"ScimUserCreateBody":{"properties":{"userName":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Username"},"email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Email"},"externalId":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Externalid"},"id":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Id"},"name":{"anyOf":[{"$ref":"#/components/schemas/ScimName"},{"type":"null"}]}},"type":"object","title":"ScimUserCreateBody"},"ScimUserUpdateBody":{"properties":{"userName":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Username"},"name":{"anyOf":[{"$ref":"#/components/schemas/ScimName"},{"type":"null"}]},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"}},"type":"object","title":"ScimUserUpdateBody"},"SetAccessBody":{"properties":{"roles":{"items":{"$ref":"#/components/schemas/Role"},"type":"array","title":"Roles"},"groups":{"items":{"type":"string","maxLength":200},"type":"array","title":"Groups"}},"type":"object","title":"SetAccessBody"},"SignupRequest":{"properties":{"company_name":{"type":"string","maxLength":300,"title":"Company Name"},"admin_email":{"type":"string","maxLength":320,"title":"Admin Email"},"admin_name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Admin Name"},"selected_plan":{"type":"string","maxLength":100,"title":"Selected Plan","default":"starter"}},"type":"object","required":["company_name","admin_email"],"title":"SignupRequest"},"SignupResendRequest":{"properties":{"admin_email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Admin Email"}},"type":"object","title":"SignupResendRequest"},"SignupVerifyRequest":{"properties":{"token":{"type":"string","maxLength":2000,"title":"Token"}},"type":"object","required":["token"],"title":"SignupVerifyRequest"},"SsoAdminRequest":{"properties":{"provider_type":{"type":"string","title":"Provider Type","default":"saml"},"metadata_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metadata Url"},"discovery_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Discovery Url"},"saml_certificate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Saml Certificate"},"attribute_mapping":{"additionalProperties":{"type":"string"},"type":"object","title":"Attribute Mapping"},"require_sso":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Require Sso"}},"type":"object","title":"SsoAdminRequest"},"SsoConfigRequest":{"properties":{"provider_type":{"type":"string","title":"Provider Type","default":"saml"},"metadata_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metadata Url"},"discovery_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Discovery Url"},"saml_certificate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Saml Certificate"},"attribute_mapping":{"additionalProperties":{"type":"string"},"type":"object","title":"Attribute Mapping"}},"type":"object","title":"SsoConfigRequest"},"StatusComponentResponse":{"properties":{"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"}},"type":"object","required":["name","status"],"title":"StatusComponentResponse"},"StatusIncidentResponse":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"severity":{"type":"string","title":"Severity"},"status":{"type":"string","title":"Status"},"component":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Component"},"started_at":{"type":"string","title":"Started At"},"resolved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolved At"}},"type":"object","required":["id","title","severity","status","started_at"],"title":"StatusIncidentResponse"},"StatusResponse":{"properties":{"status":{"type":"string","title":"Status"},"updated_at":{"type":"string","title":"Updated At"},"uptime_30d":{"type":"number","title":"Uptime 30D"},"uptime_90d":{"type":"number","title":"Uptime 90D"},"components":{"items":{"$ref":"#/components/schemas/StatusComponentResponse"},"type":"array","title":"Components"},"incidents":{"items":{"$ref":"#/components/schemas/StatusIncidentResponse"},"type":"array","title":"Incidents"}},"type":"object","required":["status","updated_at","uptime_30d","uptime_90d","components","incidents"],"title":"StatusResponse"},"SwitchOrgRequest":{"properties":{"org_id":{"type":"string","format":"uuid","title":"Org Id"}},"type":"object","required":["org_id"],"title":"SwitchOrgRequest"},"TenantConnectorCapBody":{"properties":{"connector_cap":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Connector Cap"}},"type":"object","title":"TenantConnectorCapBody"},"TenantPlanLifecycleBody":{"properties":{"action":{"type":"string","maxLength":50,"minLength":1,"title":"Action"},"target_plan":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Target Plan"},"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"}},"type":"object","required":["action"],"title":"TenantPlanLifecycleBody"},"UpdateDealBody":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Name"},"account_name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Account Name"},"stage":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Stage"},"owner":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Owner"},"notes":{"anyOf":[{"type":"string","maxLength":20000},{"type":"null"}],"title":"Notes"}},"type":"object","title":"UpdateDealBody"},"UpdateDocBody":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Name"},"tags":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Tags"}},"type":"object","title":"UpdateDocBody"},"UpdateGroupMappingBody":{"properties":{"group_name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Group Name"},"group_external_id":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Group External Id"},"role":{"anyOf":[{"$ref":"#/components/schemas/Role"},{"type":"null"}]}},"type":"object","title":"UpdateGroupMappingBody"},"UpdatePolicyBody":{"properties":{"require_sso":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Require Sso"},"require_mfa":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Require Mfa"},"agent_mode_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Agent Mode Enabled"},"session_ttl_hours":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Session Ttl Hours"},"answer_confidence_threshold":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Answer Confidence Threshold"},"reranker_provider":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Reranker Provider"},"reranker_model":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Reranker Model"},"reranker_top_n":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Reranker Top N"},"response_cache_ttl_seconds":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Response Cache Ttl Seconds"},"mode_confidence_threshold_overrides":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Mode Confidence Threshold Overrides"},"retrieval_language":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Retrieval Language"},"retrieval_stopwords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Retrieval Stopwords"},"group_sync_mode":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Group Sync Mode"},"usage_plan":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Usage Plan"},"allow_chat_overage":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Allow Chat Overage"},"monthly_query_cap":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Monthly Query Cap"},"monthly_upload_cap":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Monthly Upload Cap"},"monthly_active_user_cap":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Monthly Active User Cap"},"max_total_documents":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Max Total Documents"},"disabled_modes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Disabled Modes"},"directory_id":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Directory Id"},"data_region":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Data Region"},"ip_allowlist":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Ip Allowlist"},"custom_logo_url":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Custom Logo Url"},"custom_primary_color":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Custom Primary Color"},"custom_support_email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Custom Support Email"},"custom_embedding_model":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Custom Embedding Model"},"chat_retention_days":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Chat Retention Days"},"document_retention_days":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Document Retention Days"},"scim_token":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Scim Token"}},"type":"object","title":"UpdatePolicyBody","description":"Tenant policy controls (SSO/MFA/retention/branding/data-residency).\n\nAll fields are optional: the handler applies only those present in the\nrequest via ``model_fields_set`` (preserving the prior present-key\nsemantics of the untyped ``payload: dict``). Numeric fields accept the\nstring forms the UI still posts (``int | str``); the handler keeps its\nown clamp/range/coercion rules and returns 400 on semantic violations.\nUnknown keys are ignored (default) to stay forward-compatible with the\nadmin UI. This schema's job is type-safety plus DoS bounds on free text."},"UpdatePricingPlanBody":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"},"monthly_base_eur":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Monthly Base Eur"},"per_query_overage_eur":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Per Query Overage Eur"},"per_upload_overage_eur":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Per Upload Overage Eur"},"per_active_user_overage_eur":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Per Active User Overage Eur"},"trial_days":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Trial Days"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"}},"type":"object","title":"UpdatePricingPlanBody"},"UpdateUserBody":{"properties":{"is_active":{"type":"boolean","title":"Is Active"}},"type":"object","required":["is_active"],"title":"UpdateUserBody"},"UsageRequestApproveBody":{"properties":{"amount_eur":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Eur"},"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"}},"type":"object","title":"UsageRequestApproveBody"},"UsageRequestRejectBody":{"properties":{"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"}},"type":"object","title":"UsageRequestRejectBody"},"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"},"WebhookEndpointRequest":{"properties":{"url":{"type":"string","title":"Url"},"secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secret"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"is_active":{"type":"boolean","title":"Is Active","default":true}},"type":"object","required":["url"],"title":"WebhookEndpointRequest"}}}}