{"openapi":"3.1.0","info":{"title":"Lucion AI Mailing — Public API v1","description":"Programmatic access to your tenant's email center.\n\n**Base URL:** `https://mail.lucionesports.com`\n\n## Authentication\nAll endpoints below require a Bearer API token sent in the `Authorization` header:\n```\nAuthorization: Bearer lct_xxxxxxxxxxxxxxx\n```\nMint tokens at **Portal → Settings → Developers → API Tokens**.\n\n## Scopes\nTokens are scoped to least-privilege actions. Each endpoint documents its `scope_required`. Sending email requires the dedicated `drafts:send` scope (separate from `drafts:write`).\n\n## Tenant isolation\nEvery request is automatically filtered to the tenant that owns the API token. You cannot read or write another tenant's data.\n\n## Errors\n- `401 Unauthorized` — missing or invalid Bearer token\n- `403 Forbidden` — token lacks the required scope (response includes `scope_required`)\n- `404 Not Found` — resource doesn't exist in your tenant\n- `429 Too Many Requests` — rate limit exceeded\n","version":"1.0.0"},"paths":{"/api/v1/whoami":{"get":{"tags":["Auth"],"summary":"V1 Whoami","description":"Returns the tenant + scopes the caller's token is bound to.","operationId":"v1_whoami_api_v1_whoami_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/threads":{"get":{"tags":["Threads"],"summary":"V1 List Threads","operationId":"v1_list_threads_api_v1_threads_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/threads/{thread_id}":{"get":{"tags":["Threads"],"summary":"V1 Get Thread","operationId":"v1_get_thread_api_v1_threads__thread_id__get","parameters":[{"name":"thread_id","in":"path","required":true,"schema":{"type":"string","title":"Thread Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/escalations":{"get":{"tags":["Escalations"],"summary":"V1 List Escalations","operationId":"v1_list_escalations_api_v1_escalations_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"pending","title":"Status"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/escalations/{esc_id}/respond":{"post":{"tags":["Escalations"],"summary":"V1 Respond Escalation","operationId":"v1_respond_escalation_api_v1_escalations__esc_id__respond_post","parameters":[{"name":"esc_id","in":"path","required":true,"schema":{"type":"string","title":"Esc Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/kb":{"get":{"tags":["Knowledge Base"],"summary":"V1 List Kb","operationId":"v1_list_kb_api_v1_kb_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":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/kb/{kb_id}":{"get":{"tags":["Knowledge Base"],"summary":"V1 Get Kb","operationId":"v1_get_kb_api_v1_kb__kb_id__get","parameters":[{"name":"kb_id","in":"path","required":true,"schema":{"type":"string","title":"Kb Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ai-questions":{"get":{"tags":["AI Questions"],"summary":"V1 List Ai Questions","operationId":"v1_list_ai_questions_api_v1_ai_questions_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":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/metrics/dashboard":{"get":{"tags":["Metrics"],"summary":"V1 Metrics","description":"Lightweight metrics endpoint scoped to the API caller's tenant.","operationId":"v1_metrics_api_v1_metrics_dashboard_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/inboxes":{"get":{"tags":["Inboxes"],"summary":"V1 List Inboxes","description":"List inboxes owned by the caller's tenant. API keys are stripped.","operationId":"v1_list_inboxes_api_v1_inboxes_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/inboxes/{inbox_id}":{"get":{"tags":["Inboxes"],"summary":"V1 Get Inbox","operationId":"v1_get_inbox_api_v1_inboxes__inbox_id__get","parameters":[{"name":"inbox_id","in":"path","required":true,"schema":{"type":"string","title":"Inbox Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/drafts":{"post":{"tags":["Drafts"],"summary":"V1 Create Draft","operationId":"v1_create_draft_api_v1_drafts_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Drafts"],"summary":"V1 List Drafts","operationId":"v1_list_drafts_api_v1_drafts_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"inbox_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inbox Id"}},{"name":"thread_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thread Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/drafts/{draft_id}":{"get":{"tags":["Drafts"],"summary":"V1 Get Draft","operationId":"v1_get_draft_api_v1_drafts__draft_id__get","parameters":[{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Drafts"],"summary":"V1 Patch Draft","operationId":"v1_patch_draft_api_v1_drafts__draft_id__patch","parameters":[{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/drafts/{draft_id}/approve":{"post":{"tags":["Drafts"],"summary":"V1 Approve Draft","operationId":"v1_approve_draft_api_v1_drafts__draft_id__approve_post","parameters":[{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/drafts/{draft_id}/reject":{"post":{"tags":["Drafts"],"summary":"V1 Reject Draft","operationId":"v1_reject_draft_api_v1_drafts__draft_id__reject_post","parameters":[{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/drafts/{draft_id}/send":{"post":{"tags":["Drafts"],"summary":"V1 Send Draft","description":"Send the draft. Requires the dedicated `drafts:send` scope on top of `drafts:write`.\n\nFlexible workflow (per spec decision 1b): a `drafts:send` caller can send a draft\nin any non-terminal status. To enforce approval, omit `drafts:send` from the token\nand only grant `drafts:write` — the caller will be able to approve but not send.","operationId":"v1_send_draft_api_v1_drafts__draft_id__send_post","parameters":[{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/email/compose":{"post":{"tags":["AI Email Tools"],"summary":"V1 Email Compose","operationId":"v1_email_compose_api_v1_email_compose_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/email/summarize-thread":{"post":{"tags":["AI Email Tools"],"summary":"V1 Email Summarize","operationId":"v1_email_summarize_api_v1_email_summarize_thread_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/email/suggest-reply":{"post":{"tags":["AI Email Tools"],"summary":"V1 Email Suggest","operationId":"v1_email_suggest_api_v1_email_suggest_reply_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/audit-log":{"get":{"tags":["Audit"],"summary":"V1 Audit Log","description":"Tenant-scoped audit log read. Filters: action, resource.","operationId":"v1_audit_log_api_v1_audit_log_get","parameters":[{"name":"action","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action"}},{"name":"resource","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/activity":{"get":{"tags":["Audit"],"summary":"V1 Activity","description":"Recent activity stream — merges audit log, threads, escalations, drafts.\n\nLightweight (caps each source at limit/4) and tenant-scoped.","operationId":"v1_activity_api_v1_activity_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/campaigns":{"post":{"tags":["Campaigns"],"summary":"V1 Create Campaign","operationId":"v1_create_campaign_api_v1_campaigns_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Campaigns"],"summary":"V1 List Campaigns","operationId":"v1_list_campaigns_api_v1_campaigns_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/campaigns/{campaign_id}":{"get":{"tags":["Campaigns"],"summary":"V1 Get Campaign","operationId":"v1_get_campaign_api_v1_campaigns__campaign_id__get","parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/campaigns/{campaign_id}/generate-drafts":{"post":{"tags":["Campaigns"],"summary":"V1 Campaign Generate Drafts","operationId":"v1_campaign_generate_drafts_api_v1_campaigns__campaign_id__generate_drafts_post","parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AIModelCreate":{"properties":{"name":{"type":"string","title":"Name"},"provider":{"type":"string","enum":["openai","anthropic","gemini","emergent"],"title":"Provider"},"model_id":{"type":"string","title":"Model Id"},"api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"},"priority":{"type":"integer","title":"Priority","default":100},"active":{"type":"boolean","title":"Active","default":true},"preferred_for":{"items":{"type":"string"},"type":"array","title":"Preferred For","default":[]}},"type":"object","required":["name","provider","model_id"],"title":"AIModelCreate"},"AdminAccessCreate":{"properties":{"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["email"],"title":"AdminAccessCreate"},"AgentMailOrgKeyRequest":{"properties":{"api_key":{"type":"string","title":"Api Key"}},"type":"object","required":["api_key"],"title":"AgentMailOrgKeyRequest"},"Body_kb_upload_file_api_kb_upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_kb_upload_file_api_kb_upload_post"},"CategoryCreate":{"properties":{"org_id":{"type":"string","title":"Org Id"},"name":{"type":"string","title":"Name"},"tone":{"type":"string","title":"Tone","default":"professional"},"urgency_tier":{"type":"string","enum":["critical","high","normal","low"],"title":"Urgency Tier","default":"normal"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"response_sla_business_days":{"type":"integer","title":"Response Sla Business Days","default":0}},"type":"object","required":["org_id","name"],"title":"CategoryCreate"},"EscalationResponse":{"properties":{"response_body":{"type":"string","title":"Response Body"},"add_to_kb":{"type":"boolean","title":"Add To Kb","default":true}},"type":"object","required":["response_body"],"title":"EscalationResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"InboxCreate":{"properties":{"category_id":{"type":"string","title":"Category Id"},"email_address":{"type":"string","format":"email","title":"Email Address"},"agentmail_api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agentmail Api Key","default":""},"domain":{"type":"string","title":"Domain"}},"type":"object","required":["category_id","email_address","domain"],"title":"InboxCreate"},"InboxProvisionRequest":{"properties":{"username":{"type":"string","title":"Username"},"domain":{"type":"string","title":"Domain"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"category_id":{"type":"string","title":"Category Id"},"brand_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Label"}},"type":"object","required":["username","domain","category_id"],"title":"InboxProvisionRequest"},"InboxUpdate":{"properties":{"email_address":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email Address"},"agentmail_api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agentmail Api Key"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"brand_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Label"}},"type":"object","title":"InboxUpdate"},"IncomingEmailMock":{"properties":{"inbox_email":{"type":"string","format":"email","title":"Inbox Email"},"sender_email":{"type":"string","format":"email","title":"Sender Email"},"sender_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender Name"},"subject":{"type":"string","title":"Subject"},"body":{"type":"string","title":"Body"},"attachments":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Attachments","default":[]}},"type":"object","required":["inbox_email","sender_email","subject","body"],"title":"IncomingEmailMock"},"KBEntryCreate":{"properties":{"title":{"type":"string","title":"Title"},"content":{"type":"string","title":"Content"},"source_type":{"type":"string","enum":["manual","website","file","human_qa","ai_learned"],"title":"Source Type","default":"manual"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Id"},"category_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Id"},"is_public":{"type":"boolean","title":"Is Public","default":false}},"type":"object","required":["title","content"],"title":"KBEntryCreate"},"KBEntryUpdate":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"is_public":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Public"}},"type":"object","title":"KBEntryUpdate"},"LoginRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"pin":{"type":"string","maxLength":4,"minLength":4,"title":"Pin"}},"type":"object","required":["email","pin"],"title":"LoginRequest"},"LoginResponse":{"properties":{"token":{"type":"string","title":"Token"},"email":{"type":"string","format":"email","title":"Email"},"role":{"type":"string","title":"Role"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"assigned_categories":{"items":{"type":"string"},"type":"array","title":"Assigned Categories","default":[]},"tenant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tenant Id"}},"type":"object","required":["token","email","role"],"title":"LoginResponse"},"OrganizationCreate":{"properties":{"name":{"type":"string","title":"Name"},"parent_org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Org Id"},"brand_theme":{"type":"string","title":"Brand Theme","default":"lucion"}},"type":"object","required":["name"],"title":"OrganizationCreate"},"PinChangeRequest":{"properties":{"current_pin":{"type":"string","title":"Current Pin"},"new_pin":{"type":"string","maxLength":4,"minLength":4,"pattern":"^\\d{4}$","title":"New Pin","description":"Exactly 4 numeric digits"}},"type":"object","required":["current_pin","new_pin"],"title":"PinChangeRequest"},"PinResetRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["email"],"title":"PinResetRequest"},"ReportRecipientCreate":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"scope_description":{"type":"string","title":"Scope Description"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories","default":[]},"enabled":{"type":"boolean","title":"Enabled","default":true},"timezone":{"type":"string","title":"Timezone","default":"America/New_York"},"send_hour":{"type":"integer","title":"Send Hour","default":8}},"type":"object","required":["email","scope_description"],"title":"ReportRecipientCreate"},"RoutingRuleCreate":{"properties":{"name":{"type":"string","title":"Name"},"trigger_keywords":{"items":{"type":"string"},"type":"array","title":"Trigger Keywords","default":[]},"category_ids":{"items":{"type":"string"},"type":"array","title":"Category Ids","default":[]},"destination_email":{"type":"string","format":"email","title":"Destination Email"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"active":{"type":"boolean","title":"Active","default":true}},"type":"object","required":["name","destination_email"],"title":"RoutingRuleCreate"},"StaffCreate":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"role":{"type":"string","enum":["super_admin","department_admin","read_only"],"title":"Role","default":"department_admin"},"assigned_categories":{"items":{"type":"string"},"type":"array","title":"Assigned Categories","default":[]},"report_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Scope"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"pin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pin"}},"type":"object","required":["email"],"title":"StaffCreate"},"StaffUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"assigned_categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Assigned Categories"},"report_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Scope"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","title":"StaffUpdate"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WebsiteScanCreate":{"properties":{"url":{"type":"string","title":"Url"},"enabled":{"type":"boolean","title":"Enabled","default":true},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["url"],"title":"WebsiteScanCreate"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"lct_xxx","description":"Mint at Portal → Settings → Developers → API Tokens"}}},"servers":[{"url":"https://mail.lucionesports.com","description":"Production"}],"security":[{"BearerAuth":[]}]}