{"openapi":"3.1.0","info":{"title":"Mephistopheles API","summary":"Evidence verification for AI","version":"2.0.0"},"servers":[{"url":"https://api.mephistopheles.ai/v1","description":"production"}],"paths":{"/v1/verifications":{"post":{"tags":["verifications"],"summary":"Create Verification","operationId":"create_verification_v1_verifications_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/claims/verify":{"post":{"tags":["verifications"],"summary":"Verify Claim Direct","operationId":"verify_claim_direct_v1_claims_verify_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectClaimRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/batches":{"post":{"tags":["verifications"],"summary":"Batch Verify","operationId":"batch_verify_v1_batches_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verifications/{verification_id}":{"get":{"tags":["verifications"],"summary":"Get Verification","operationId":"get_verification_v1_verifications__verification_id__get","parameters":[{"name":"verification_id","in":"path","required":true,"schema":{"type":"string","title":"Verification Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verifications/{verification_id}/export":{"get":{"tags":["verifications"],"summary":"Export Verification","operationId":"export_verification_v1_verifications__verification_id__export_get","parameters":[{"name":"verification_id","in":"path","required":true,"schema":{"type":"string","title":"Verification Id"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(html|json)$","default":"html","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/policies":{"get":{"tags":["configuration"],"summary":"Policies","operationId":"policies_v1_policies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/models":{"get":{"tags":["configuration"],"summary":"Models","operationId":"models_v1_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/engine":{"get":{"tags":["configuration"],"summary":"Engine Versions","operationId":"engine_versions_v1_engine_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/documents":{"post":{"tags":["documents"],"summary":"Submit Document","operationId":"submit_document_v1_documents_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_submit_document_v1_documents_post"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentJobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/documents/{job_id}":{"get":{"tags":["documents"],"summary":"Document Status","operationId":"document_status_v1_documents__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"X-Job-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Job-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentJobStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/documents/{job_id}/artifacts/{artifact_id}":{"get":{"tags":["documents"],"summary":"Document Artifact","operationId":"document_artifact_v1_documents__job_id__artifacts__artifact_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","title":"Artifact Id"}},{"name":"X-Job-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Job-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/documents/{job_id}/cancel":{"post":{"tags":["documents"],"summary":"Cancel Document","operationId":"cancel_document_v1_documents__job_id__cancel_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"X-Job-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Job-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentJobStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/documents/{job_id}/retry":{"post":{"tags":["documents"],"summary":"Retry Document","operationId":"retry_document_v1_documents__job_id__retry_post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"X-Job-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Job-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentJobStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sessions/{session_id}":{"delete":{"tags":["authentication"],"summary":"Revoke Session","operationId":"revoke_session_v1_sessions__session_id__delete","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sessions":{"delete":{"tags":["authentication"],"summary":"Revoke All Sessions","operationId":"revoke_all_sessions_v1_sessions_delete","responses":{"204":{"description":"Successful Response"}}}},"/v1/billing/checkout":{"post":{"tags":["billing"],"summary":"Billing Checkout","operationId":"billing_checkout_v1_billing_checkout_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/billing/portal":{"post":{"tags":["billing"],"summary":"Billing Portal","operationId":"billing_portal_v1_billing_portal_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/api-keys":{"post":{"tags":["authentication"],"summary":"Api Key Create","operationId":"api_key_create_v1_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreated"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api-keys/{key_id}":{"delete":{"tags":["authentication"],"summary":"Revoke Api Key","operationId":"revoke_api_key_v1_api_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api-keys/{key_id}/rotate":{"post":{"tags":["authentication"],"summary":"Rotate Api Key","operationId":"rotate_api_key_v1_api_keys__key_id__rotate_post","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreated"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/organizations":{"get":{"tags":["organizations"],"summary":"List Organizations","operationId":"list_organizations_v1_organizations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["organizations"],"summary":"Create Organization","operationId":"create_organization_v1_organizations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/organizations/{organization_id}/settings":{"patch":{"tags":["organizations"],"summary":"Update Organization Settings","operationId":"update_organization_settings_v1_organizations__organization_id__settings_patch","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationSettingsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/organizations/{organization_id}/policies":{"get":{"tags":["configuration"],"summary":"List Organization Policies","operationId":"list_organization_policies_v1_organizations__organization_id__policies_get","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["configuration"],"summary":"Create Organization Policy","operationId":"create_organization_policy_v1_organizations__organization_id__policies_post","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/organizations/{organization_id}/policies/{policy_id}":{"delete":{"tags":["configuration"],"summary":"Deactivate Organization Policy","operationId":"deactivate_organization_policy_v1_organizations__organization_id__policies__policy_id__delete","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}},{"name":"policy_id","in":"path","required":true,"schema":{"type":"string","title":"Policy Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/organizations/{organization_id}/usage":{"get":{"tags":["usage"],"summary":"Organization Usage","operationId":"organization_usage_v1_organizations__organization_id__usage_get","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/usage/estimate":{"get":{"tags":["usage"],"summary":"Usage Estimate","operationId":"usage_estimate_v1_usage_estimate_get","parameters":[{"name":"characters","in":"query","required":true,"schema":{"type":"integer","maximum":100000,"minimum":1,"title":"Characters"}},{"name":"estimated_claims","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":0,"default":5,"title":"Estimated Claims"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/organizations/{organization_id}/audit-events":{"get":{"tags":["audit"],"summary":"Organization Audit Events","operationId":"organization_audit_events_v1_organizations__organization_id__audit_events_get","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/organizations/{organization_id}/members":{"get":{"tags":["organizations"],"summary":"List Members","operationId":"list_members_v1_organizations__organization_id__members_get","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["organizations"],"summary":"Add Member","operationId":"add_member_v1_organizations__organization_id__members_post","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberAddRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/organizations/{organization_id}/projects":{"post":{"tags":["organizations"],"summary":"Create Project","operationId":"create_project_v1_organizations__organization_id__projects_post","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/organizations/{organization_id}/source-sets":{"get":{"tags":["source sets"],"summary":"List Source Sets","operationId":"list_source_sets_v1_organizations__organization_id__source_sets_get","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["source sets"],"summary":"Create Source Set","operationId":"create_source_set_v1_organizations__organization_id__source_sets_post","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceSetCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/organizations/{organization_id}/source-sets/{source_set_id}/resources":{"post":{"tags":["source sets"],"summary":"Add Source Resource","operationId":"add_source_resource_v1_organizations__organization_id__source_sets__source_set_id__resources_post","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}},{"name":"source_set_id","in":"path","required":true,"schema":{"type":"string","title":"Source Set Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResourceCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/organizations/{organization_id}/source-sets/{source_set_id}/resources/{resource_id}":{"delete":{"tags":["source sets"],"summary":"Disable Source Resource","operationId":"disable_source_resource_v1_organizations__organization_id__source_sets__source_set_id__resources__resource_id__delete","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}},{"name":"source_set_id","in":"path","required":true,"schema":{"type":"string","title":"Source Set Id"}},{"name":"resource_id","in":"path","required":true,"schema":{"type":"string","title":"Resource Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/organizations/{organization_id}/provider-connections":{"get":{"tags":["provider connections"],"summary":"List Provider Connections","operationId":"list_provider_connections_v1_organizations__organization_id__provider_connections_get","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["provider connections"],"summary":"Create Provider Connection","operationId":"create_provider_connection_v1_organizations__organization_id__provider_connections_post","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderConnectionRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/organizations/{organization_id}/provider-connections/{connection_id}/rotate":{"post":{"tags":["provider connections"],"summary":"Rotate Provider Connection","operationId":"rotate_provider_connection_v1_organizations__organization_id__provider_connections__connection_id__rotate_post","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}},{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","title":"Connection Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCredentialRotateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/organizations/{organization_id}/provider-connections/{connection_id}":{"delete":{"tags":["provider connections"],"summary":"Revoke Provider Connection","operationId":"revoke_provider_connection_v1_organizations__organization_id__provider_connections__connection_id__delete","parameters":[{"name":"organization_id","in":"path","required":true,"schema":{"type":"string","title":"Organization Id"}},{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","title":"Connection Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks":{"post":{"tags":["webhooks"],"summary":"Create Webhook","operationId":"create_webhook_v1_webhooks_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreated"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/{webhook_id}":{"delete":{"tags":["webhooks"],"summary":"Disable Webhook","operationId":"disable_webhook_v1_webhooks__webhook_id__delete","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","title":"Webhook Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/reviews":{"get":{"tags":["review"],"summary":"Review Queue","operationId":"review_queue_v1_reviews_get","parameters":[{"name":"status_filter","in":"query","required":false,"schema":{"type":"string","default":"open","title":"Status Filter"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verifications/{verification_id}/reviews":{"post":{"tags":["review"],"summary":"Review Claim","operationId":"review_claim_v1_verifications__verification_id__reviews_post","parameters":[{"name":"verification_id","in":"path","required":true,"schema":{"type":"string","title":"Verification Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/completions":{"post":{"tags":["OpenAI compatibility"],"summary":"Chat Completions","operationId":"chat_completions_v1_chat_completions_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AbstentionSummary":{"properties":{"count":{"type":"integer","minimum":0.0,"title":"Count"},"rate":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Rate"},"material_count":{"type":"integer","minimum":0.0,"title":"Material Count"},"explanation":{"type":"string","title":"Explanation"}},"additionalProperties":false,"type":"object","required":["count","rate","material_count","explanation"],"title":"AbstentionSummary"},"ApiKeyCreateRequest":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"environment":{"type":"string","enum":["development","production"],"title":"Environment","default":"development"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"quota_per_hour":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Quota Per Hour","default":100},"monthly_cost_limit_cents":{"anyOf":[{"type":"integer","maximum":10000000.0,"minimum":100.0},{"type":"null"}],"title":"Monthly Cost Limit Cents"},"allowed_ips":{"items":{"type":"string"},"type":"array","maxItems":50,"title":"Allowed Ips"}},"additionalProperties":false,"type":"object","required":["name"],"title":"ApiKeyCreateRequest"},"ApiKeyCreated":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"prefix":{"type":"string","title":"Prefix"},"secret":{"type":"string","title":"Secret"},"environment":{"type":"string","title":"Environment"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"warning":{"type":"string","title":"Warning","default":"This secret is shown once. Store it securely; Mephistopheles stores only its hash."}},"type":"object","required":["id","name","prefix","secret","environment","scopes"],"title":"ApiKeyCreated"},"BatchVerifyRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/VerifyRequest"},"type":"array","maxItems":20,"minItems":1,"title":"Items"}},"additionalProperties":false,"type":"object","required":["items"],"title":"BatchVerifyRequest"},"Body_submit_document_v1_documents_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"profile":{"type":"string","title":"Profile","default":"general_web"},"retention_hours":{"type":"integer","title":"Retention Hours","default":24},"zero_retention":{"type":"boolean","title":"Zero Retention","default":false}},"type":"object","required":["file"],"title":"Body_submit_document_v1_documents_post"},"ChatCompletionRequest":{"properties":{"model":{"type":"string","maxLength":200,"minLength":1,"title":"Model"},"messages":{"items":{"$ref":"#/components/schemas/ChatMessage"},"type":"array","maxItems":100,"minItems":1,"title":"Messages"},"stream":{"type":"boolean","title":"Stream","default":false},"max_tokens":{"anyOf":[{"type":"integer","maximum":8192.0,"minimum":1.0},{"type":"null"}],"title":"Max Tokens"},"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","default":0}},"additionalProperties":false,"type":"object","required":["model","messages"],"title":"ChatCompletionRequest"},"ChatMessage":{"properties":{"role":{"type":"string","enum":["system","user","assistant"],"title":"Role"},"content":{"type":"string","maxLength":100000,"minLength":1,"title":"Content"}},"additionalProperties":false,"type":"object","required":["role","content"],"title":"ChatMessage"},"CheckoutRequest":{"properties":{"plan":{"type":"string","const":"developer","title":"Plan","default":"developer"}},"additionalProperties":false,"type":"object","title":"CheckoutRequest"},"ClaimLocation":{"properties":{"start":{"type":"integer","minimum":0.0,"title":"Start"},"end":{"type":"integer","minimum":0.0,"title":"End"},"page":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Page"},"chunk":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Chunk"}},"additionalProperties":false,"type":"object","required":["start","end"],"title":"ClaimLocation"},"ClaimRecord":{"properties":{"id":{"type":"string","title":"Id"},"original_span":{"type":"string","title":"Original Span"},"location":{"$ref":"#/components/schemas/ClaimLocation"},"normalized_claim":{"type":"string","title":"Normalized Claim"},"verification":{"$ref":"#/components/schemas/ClaimVerificationRecord"},"claim_type":{"type":"string","title":"Claim Type"},"entities":{"items":{"type":"string"},"type":"array","title":"Entities"},"dates_and_temporal_scope":{"items":{"type":"string"},"type":"array","title":"Dates And Temporal Scope"},"quantities_and_units":{"items":{"type":"string"},"type":"array","title":"Quantities And Units"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction"},"ambiguous_dependencies":{"items":{"type":"string"},"type":"array","title":"Ambiguous Dependencies"},"materiality":{"$ref":"#/components/schemas/Materiality"},"verdict":{"$ref":"#/components/schemas/Verdict"},"reliability":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Reliability"},"supporting_evidence":{"items":{"$ref":"#/components/schemas/EvidenceItem"},"type":"array","title":"Supporting Evidence"},"opposing_evidence":{"items":{"$ref":"#/components/schemas/EvidenceItem"},"type":"array","title":"Opposing Evidence"},"contextual_evidence":{"items":{"$ref":"#/components/schemas/EvidenceItem"},"type":"array","title":"Contextual Evidence"},"policy_reason":{"type":"string","title":"Policy Reason"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"},"unresolved_ambiguity":{"items":{"type":"string"},"type":"array","title":"Unresolved Ambiguity"},"correction":{"anyOf":[{"$ref":"#/components/schemas/Correction"},{"type":"null"}]},"human_review_status":{"type":"string","enum":["unreviewed","accepted","overridden","needs_evidence"],"title":"Human Review Status","default":"unreviewed"}},"additionalProperties":false,"type":"object","required":["id","original_span","location","normalized_claim","verification","claim_type","materiality","verdict","reliability","policy_reason"],"title":"ClaimRecord"},"ClaimVerificationRecord":{"properties":{"verification_profile":{"type":"string","title":"Verification Profile"},"policy_name":{"type":"string","title":"Policy Name"},"policy_version":{"type":"string","title":"Policy Version"},"verification_timestamp":{"type":"string","format":"date-time","title":"Verification Timestamp"},"extraction_model":{"type":"string","title":"Extraction Model"},"extraction_version":{"type":"string","title":"Extraction Version"},"retrieval_configuration":{"type":"string","title":"Retrieval Configuration"},"judge_configuration":{"type":"string","title":"Judge Configuration"}},"additionalProperties":false,"type":"object","required":["verification_profile","policy_name","policy_version","verification_timestamp","extraction_model","extraction_version","retrieval_configuration","judge_configuration"],"title":"ClaimVerificationRecord","description":"The exact policy and engine configuration applied to one atomic claim."},"Correction":{"properties":{"original":{"type":"string","title":"Original"},"suggested":{"type":"string","title":"Suggested"},"diff":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Diff"},"reverified_result_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reverified Result Id"},"reverified_verdict":{"$ref":"#/components/schemas/Verdict"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"}},"additionalProperties":false,"type":"object","required":["original","suggested","diff","reverified_verdict"],"title":"Correction"},"CoverageSummary":{"properties":{"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score"},"status":{"type":"string","enum":["complete","qualified","incomplete"],"title":"Status"},"extracted_material_claims":{"type":"integer","minimum":0.0,"title":"Extracted Material Claims"},"estimated_material_claims":{"type":"integer","minimum":0.0,"title":"Estimated Material Claims"},"missing_or_uncertain_spans":{"items":{"type":"string"},"type":"array","title":"Missing Or Uncertain Spans"},"method":{"type":"string","title":"Method"},"threshold":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Threshold"}},"additionalProperties":false,"type":"object","required":["score","status","extracted_material_claims","estimated_material_claims","method","threshold"],"title":"CoverageSummary"},"DirectClaimRequest":{"properties":{"claim":{"type":"string","maxLength":4000,"minLength":1,"title":"Claim"},"profile":{"type":"string","title":"Profile","default":"general_web"},"retention_hours":{"type":"integer","maximum":720.0,"minimum":0.0,"title":"Retention Hours","default":24}},"additionalProperties":false,"type":"object","required":["claim"],"title":"DirectClaimRequest"},"DocumentJobResponse":{"properties":{"request_id":{"type":"string","title":"Request Id"},"job_id":{"type":"string","title":"Job Id"},"access_token":{"type":"string","title":"Access Token"},"status_url":{"type":"string","title":"Status Url"},"cancellation_url":{"type":"string","title":"Cancellation Url"},"validation":{"additionalProperties":true,"type":"object","title":"Validation"},"estimated_seconds":{"additionalProperties":{"type":"integer"},"type":"object","title":"Estimated Seconds"},"idempotency_replayed":{"type":"boolean","title":"Idempotency Replayed","default":false}},"type":"object","required":["request_id","job_id","access_token","status_url","cancellation_url","validation","estimated_seconds"],"title":"DocumentJobResponse"},"DocumentJobStatus":{"properties":{"request_id":{"type":"string","title":"Request Id"},"job_id":{"type":"string","title":"Job Id"},"status":{"type":"string","title":"Status"},"stage":{"type":"string","title":"Stage"},"progress":{"type":"integer","title":"Progress"},"cancel_requested":{"type":"boolean","title":"Cancel Requested"},"attempts":{"type":"integer","title":"Attempts"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"source_context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Context"},"artifacts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Artifacts"},"result":{"anyOf":[{"$ref":"#/components/schemas/VerificationResult"},{"type":"null"}]}},"type":"object","required":["request_id","job_id","status","stage","progress","cancel_requested","attempts","error_code"],"title":"DocumentJobStatus"},"EngineRecord":{"properties":{"extraction_model":{"type":"string","title":"Extraction Model"},"extraction_version":{"type":"string","title":"Extraction Version"},"retrieval_configuration":{"type":"string","title":"Retrieval Configuration"},"judge_configuration":{"type":"string","title":"Judge Configuration"},"policy_version":{"type":"string","title":"Policy Version"},"result_schema_version":{"type":"string","title":"Result Schema Version","default":"1.1.0"}},"additionalProperties":false,"type":"object","required":["extraction_model","extraction_version","retrieval_configuration","judge_configuration","policy_version"],"title":"EngineRecord"},"EvidenceItem":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"publisher":{"type":"string","title":"Publisher"},"canonical_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Canonical Url"},"destination_domain":{"type":"string","title":"Destination Domain"},"publication_or_effective_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publication Or Effective Date"},"retrieved_at":{"type":"string","format":"date-time","title":"Retrieved At"},"source_class":{"type":"string","title":"Source Class"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction"},"passage":{"type":"string","title":"Passage"},"relationship":{"type":"string","enum":["supports","contradicts","context","unresolved"],"title":"Relationship"},"relationship_explanation":{"type":"string","title":"Relationship Explanation"},"quality":{"$ref":"#/components/schemas/SourceQuality"},"licence_or_usage_constraints":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Licence Or Usage Constraints"},"retrieval_provider":{"type":"string","title":"Retrieval Provider"},"independence_cluster":{"type":"string","title":"Independence Cluster"}},"additionalProperties":false,"type":"object","required":["id","title","publisher","canonical_url","destination_domain","retrieved_at","source_class","passage","relationship","relationship_explanation","quality","retrieval_provider","independence_cluster"],"title":"EvidenceItem"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Materiality":{"type":"string","enum":["low","medium","high"],"title":"Materiality"},"MemberAddRequest":{"properties":{"email":{"type":"string","maxLength":320,"minLength":3,"title":"Email"},"role":{"type":"string","enum":["admin","developer","reviewer","viewer"],"title":"Role","default":"viewer"}},"additionalProperties":false,"type":"object","required":["email"],"title":"MemberAddRequest"},"OrganizationCreateRequest":{"properties":{"name":{"type":"string","maxLength":160,"minLength":2,"title":"Name"}},"additionalProperties":false,"type":"object","required":["name"],"title":"OrganizationCreateRequest"},"OrganizationSettingsRequest":{"properties":{"retention_hours":{"type":"integer","maximum":720.0,"minimum":0.0,"title":"Retention Hours"},"zero_retention":{"type":"boolean","title":"Zero Retention","default":false},"exports_enabled":{"type":"boolean","title":"Exports Enabled","default":true},"monthly_cost_limit_cents":{"anyOf":[{"type":"integer","maximum":100000000.0,"minimum":100.0},{"type":"null"}],"title":"Monthly Cost Limit Cents"}},"additionalProperties":false,"type":"object","required":["retention_hours"],"title":"OrganizationSettingsRequest"},"PolicyCreateRequest":{"properties":{"name":{"type":"string","maxLength":80,"minLength":2,"title":"Name"},"version":{"type":"string","maxLength":32,"minLength":1,"pattern":"^[A-Za-z0-9._-]+$","title":"Version"},"base_profile":{"type":"string","enum":["general_web","research_citations","legal_regulatory","medical_clinical","finance_markets","internal_enterprise"],"title":"Base Profile"},"source_set_id":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Source Set Id"},"minimum_independent_sources":{"anyOf":[{"type":"integer","maximum":10.0,"minimum":1.0},{"type":"null"}],"title":"Minimum Independent Sources"},"authoritative_source_can_decide":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Authoritative Source Can Decide"},"coverage_threshold":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.65},{"type":"null"}],"title":"Coverage Threshold"}},"additionalProperties":false,"type":"object","required":["name","version","base_profile"],"title":"PolicyCreateRequest"},"ProjectCreateRequest":{"properties":{"name":{"type":"string","maxLength":160,"minLength":2,"title":"Name"}},"additionalProperties":false,"type":"object","required":["name"],"title":"ProjectCreateRequest"},"ProviderConnectionRequest":{"properties":{"provider":{"type":"string","enum":["openrouter","anthropic","openai","google","tavily","exa","serper","brave"],"title":"Provider"},"label":{"type":"string","maxLength":120,"minLength":2,"title":"Label","default":"default"},"credential":{"type":"string","maxLength":4096,"minLength":8,"format":"password","title":"Credential","writeOnly":true}},"additionalProperties":false,"type":"object","required":["provider","credential"],"title":"ProviderConnectionRequest"},"ProviderCredentialRotateRequest":{"properties":{"credential":{"type":"string","maxLength":4096,"minLength":8,"format":"password","title":"Credential","writeOnly":true}},"additionalProperties":false,"type":"object","required":["credential"],"title":"ProviderCredentialRotateRequest"},"ResultCounts":{"properties":{"supported":{"type":"integer","title":"Supported","default":0},"contradicted":{"type":"integer","title":"Contradicted","default":0},"disputed":{"type":"integer","title":"Disputed","default":0},"unverifiable":{"type":"integer","title":"Unverifiable","default":0},"not_checkable":{"type":"integer","title":"Not Checkable","default":0}},"additionalProperties":false,"type":"object","title":"ResultCounts"},"ReviewRequest":{"properties":{"claim_id":{"type":"string","title":"Claim Id"},"action":{"type":"string","enum":["accept","override","request_evidence","assign","resolve","reopen"],"title":"Action"},"decision":{"anyOf":[{"type":"string","enum":["supported","contradicted","disputed","unverifiable","not_checkable"]},{"type":"null"}],"title":"Decision"},"explanation":{"type":"string","maxLength":4000,"minLength":3,"title":"Explanation"},"assigned_to_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned To User Id"},"due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due At"}},"additionalProperties":false,"type":"object","required":["claim_id","action","explanation"],"title":"ReviewRequest"},"RiskSummary":{"properties":{"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score"},"level":{"type":"string","enum":["low","medium","high","critical"],"title":"Level"},"model_version":{"type":"string","title":"Model Version"},"drivers":{"items":{"type":"string"},"type":"array","title":"Drivers"}},"additionalProperties":false,"type":"object","required":["score","level","model_version","drivers"],"title":"RiskSummary"},"SourceQuality":{"properties":{"authority":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Authority"},"independence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Independence"},"freshness":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Freshness"},"specificity":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Specificity"},"primary":{"type":"boolean","title":"Primary"},"rationale":{"items":{"type":"string"},"type":"array","title":"Rationale"}},"additionalProperties":false,"type":"object","required":["authority","independence","freshness","specificity","primary"],"title":"SourceQuality"},"SourceResourceCreateRequest":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":12,"title":"Url"},"label":{"type":"string","maxLength":200,"minLength":2,"title":"Label"},"source_class":{"type":"string","maxLength":80,"minLength":2,"title":"Source Class","default":"customer_approved"}},"additionalProperties":false,"type":"object","required":["url","label"],"title":"SourceResourceCreateRequest"},"SourceSetCreateRequest":{"properties":{"name":{"type":"string","maxLength":120,"minLength":2,"title":"Name"},"description":{"type":"string","maxLength":2000,"title":"Description","default":""}},"additionalProperties":false,"type":"object","required":["name"],"title":"SourceSetCreateRequest"},"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"},"Verdict":{"type":"string","enum":["supported","contradicted","disputed","unverifiable","not_checkable"],"title":"Verdict"},"VerificationResult":{"properties":{"id":{"type":"string","title":"Id"},"request_id":{"type":"string","title":"Request Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"verification_timestamp":{"type":"string","format":"date-time","title":"Verification Timestamp"},"profile":{"type":"string","title":"Profile"},"policy_name":{"type":"string","title":"Policy Name"},"policy_version":{"type":"string","title":"Policy Version"},"original_content_fingerprint":{"type":"string","title":"Original Content Fingerprint"},"claims":{"items":{"$ref":"#/components/schemas/ClaimRecord"},"type":"array","title":"Claims"},"counts":{"$ref":"#/components/schemas/ResultCounts"},"coverage":{"$ref":"#/components/schemas/CoverageSummary"},"risk":{"$ref":"#/components/schemas/RiskSummary"},"abstention":{"$ref":"#/components/schemas/AbstentionSummary"},"overall_statement":{"type":"string","title":"Overall Statement"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"},"engine":{"$ref":"#/components/schemas/EngineRecord"}},"additionalProperties":false,"type":"object","required":["id","request_id","created_at","expires_at","verification_timestamp","profile","policy_name","policy_version","original_content_fingerprint","claims","counts","coverage","risk","abstention","overall_statement","limitations","engine"],"title":"VerificationResult"},"VerifyRequest":{"properties":{"content":{"type":"string","maxLength":100000,"minLength":1,"title":"Content"},"question":{"type":"string","maxLength":4000,"title":"Question","default":""},"profile":{"type":"string","title":"Profile","default":"general_web"},"mode":{"type":"string","enum":["thorough","triage","fast"],"title":"Mode","default":"thorough"},"retention_hours":{"type":"integer","maximum":720.0,"minimum":0.0,"title":"Retention Hours","default":24},"zero_retention":{"type":"boolean","title":"Zero Retention","default":false},"source_set_id":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Source Set Id"}},"additionalProperties":false,"type":"object","required":["content"],"title":"VerifyRequest"},"VerifyResponse":{"properties":{"request_id":{"type":"string","title":"Request Id"},"result":{"$ref":"#/components/schemas/VerificationResult"}},"type":"object","required":["request_id","result"],"title":"VerifyResponse"},"WebhookCreateRequest":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":12,"title":"Url"},"events":{"items":{"type":"string","const":"verification.completed"},"type":"array","title":"Events"}},"additionalProperties":false,"type":"object","required":["url"],"title":"WebhookCreateRequest"},"WebhookCreated":{"properties":{"id":{"type":"string","title":"Id"},"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"signing_secret":{"type":"string","title":"Signing Secret"},"warning":{"type":"string","title":"Warning","default":"This signing secret is shown once. Store it securely; Mephistopheles stores only encrypted key material."}},"type":"object","required":["id","url","events","signing_secret"],"title":"WebhookCreated"}}}}