{"openapi":"3.1.0","info":{"title":"Outbox API — LiveOne","version":"1.0.0","description":"Platform-wide lifecycle for AI-generated personalized outbound content (drafts, revisions, forward log, scheduled sends)."},"components":{"schemas":{"ApiError":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"example":false},"error":{"type":"object","properties":{"code":{"type":"string","example":"UNAUTHORIZED"},"message":{"type":"string","example":"Authentication required"},"docsUrl":{"type":"string","example":"/api/reference#tag/errors/unauthorized"},"details":{"type":"object","additionalProperties":{},"example":{"field":"email"}},"retryAfter":{"type":"number","example":60},"field":{"type":"string","example":"email"}},"required":["code","message"]},"requestId":{"type":"string","example":"550e8400-e29b-41d4-a716-446655440000"}},"required":["success","error","requestId"]}},"parameters":{}},"paths":{"/v1/outbox/drafts":{"post":{"tags":["Outbox: Drafts"],"requestBody":{"description":"Draft to create","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"context_type":{"type":"string","enum":["engagement","crm_deal","crm_contact","calendar_event","proposal","standalone","brand_commander_post"]},"context_id":{"type":"string"},"context_data":{"type":"object","additionalProperties":{}},"kind":{"type":"string","enum":["email","whatsapp","sms","note","linkedin","slack_dm","telegram"]},"title":{"type":"string","maxLength":300},"subject":{"type":"string","maxLength":500},"body":{"type":"string","minLength":1},"body_format":{"type":"string","enum":["markdown","html","plain"]},"language":{"type":"string","enum":["en","es","fr","de","pt","ja","zh","ko"]},"source":{"type":"string","enum":["manual","ai_composed","voice_note","template"]},"ai_model":{"type":"string"},"ai_prompt":{"type":"string"},"ai_prompt_module":{"type":"string"},"tokens_used":{"type":"integer"},"duration_ms":{"type":"integer"},"reasoning":{"type":"string"},"recipient_hint":{"type":"string"},"conversation_id":{"type":"string"},"message_id":{"type":"string"},"voice_note_recall_chunk_id":{"type":"string"},"variant_label":{"type":"string"}},"required":["context_type","kind","body"]}}}},"responses":{"201":{"description":"Draft created with revision 1","content":{"application/json":{"schema":{"type":"object","properties":{"draft":{"type":"object","properties":{"id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"context_type":{"type":"string"},"context_id":{"type":["string","null"]},"context_data":{"type":["object","null"],"additionalProperties":{}},"kind":{"type":"string"},"title":{"type":["string","null"]},"subject":{"type":["string","null"]},"body":{"type":"string"},"body_format":{"type":"string"},"language":{"type":"string"},"detected_language":{"type":["string","null"]},"translation_group_id":{"type":["string","null"]},"is_translation_of":{"type":["string","null"]},"status":{"type":"string"},"source":{"type":"string"},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"reasoning":{"type":["string","null"]},"recipient":{"type":"object","properties":{"name":{"type":["string","null"]},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"language":{"type":["string","null"]},"source":{"type":["string","null"]},"contact_id":{"type":["string","null"]},"account_id":{"type":["string","null"]},"relationship":{"type":["string","null"]}},"required":["name","email","phone","language","source","contact_id","account_id","relationship"]},"lineage_id":{"type":"string"},"variant_label":{"type":["string","null"]},"superseded_by":{"type":["string","null"]},"superseded_at":{"type":["integer","null"]},"conversation_id":{"type":["string","null"]},"message_id":{"type":["string","null"]},"voice_note_recall_chunk_id":{"type":["string","null"]},"r2_key":{"type":["string","null"]},"revisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"revision":{"type":"integer"},"subject":{"type":["string","null"]},"body":{"type":"string"},"content_hash":{"type":["string","null"]},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"tokens_used":{"type":["integer","null"]},"duration_ms":{"type":["integer","null"]},"guardrails_status":{"type":["string","null"]},"guardrails_notes":{"type":["string","null"]},"change_summary":{"type":["string","null"]},"change_reason":{"type":["string","null"]},"created_at":{"type":"integer"},"created_by":{"type":"string"}},"required":["id","draft_id","revision","subject","body","content_hash","ai_generated","ai_model","ai_prompt_module","tokens_used","duration_ms","guardrails_status","guardrails_notes","change_summary","change_reason","created_at","created_by"]}},"forward_log":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"action":{"type":"string"},"channel":{"type":["string","null"]},"external_id":{"type":["string","null"]},"external_url":{"type":["string","null"]},"ip_address":{"type":["string","null"]},"user_agent":{"type":["string","null"]},"geolocation":{"type":["string","null"]},"session_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"inbound_from_email":{"type":["string","null"]},"inbound_from_phone":{"type":["string","null"]},"inbound_body":{"type":["string","null"]},"inbound_language":{"type":["string","null"]},"inbound_translated_body":{"type":["string","null"]},"metadata":{"type":["object","null"],"additionalProperties":{}},"created_at":{"type":"integer"}},"required":["id","draft_id","organization_id","user_id","action","channel","external_id","external_url","ip_address","user_agent","geolocation","session_id","request_id","inbound_from_email","inbound_from_phone","inbound_body","inbound_language","inbound_translated_body","metadata","created_at"]}},"forward_count":{"type":"integer"},"view_count":{"type":"integer"},"last_forwarded_at":{"type":["integer","null"]},"last_forwarded_via":{"type":["string","null"]},"has_inbound_reply":{"type":"boolean"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"created_by":{"type":"string"},"archived_at":{"type":["integer","null"]}},"required":["id","organization_id","user_id","context_type","context_id","context_data","kind","title","subject","body","body_format","language","detected_language","translation_group_id","is_translation_of","status","source","ai_generated","ai_model","ai_prompt_module","reasoning","recipient","lineage_id","variant_label","superseded_by","superseded_at","conversation_id","message_id","voice_note_recall_chunk_id","r2_key","created_at","updated_at","created_by","archived_at"]},"revision":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"revision":{"type":"integer"},"subject":{"type":["string","null"]},"body":{"type":"string"},"content_hash":{"type":["string","null"]},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"tokens_used":{"type":["integer","null"]},"duration_ms":{"type":["integer","null"]},"guardrails_status":{"type":["string","null"]},"guardrails_notes":{"type":["string","null"]},"change_summary":{"type":["string","null"]},"change_reason":{"type":["string","null"]},"created_at":{"type":"integer"},"created_by":{"type":"string"}},"required":["id","draft_id","revision","subject","body","content_hash","ai_generated","ai_model","ai_prompt_module","tokens_used","duration_ms","guardrails_status","guardrails_notes","change_summary","change_reason","created_at","created_by"]}},"required":["draft","revision"]}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"get":{"tags":["Outbox: Drafts"],"parameters":[{"schema":{"type":"string","enum":["engagement","crm_deal","crm_contact","calendar_event","proposal","standalone","brand_commander_post"]},"required":false,"name":"context_type","in":"query"},{"schema":{"type":"string"},"required":false,"name":"context_id","in":"query"},{"schema":{"type":"string"},"required":false,"name":"status","in":"query"},{"schema":{"type":"string"},"required":false,"name":"user_id","in":"query"},{"schema":{"type":"string","enum":["email","whatsapp","sms","note","linkedin","slack_dm","telegram"]},"required":false,"name":"kind","in":"query"},{"schema":{"anyOf":[{"type":"boolean"},{"type":"string"}]},"required":false,"name":"include_translations","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Drafts for the context/filter","content":{"application/json":{"schema":{"type":"object","properties":{"drafts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"context_type":{"type":"string"},"context_id":{"type":["string","null"]},"context_data":{"type":["object","null"],"additionalProperties":{}},"kind":{"type":"string"},"title":{"type":["string","null"]},"subject":{"type":["string","null"]},"body":{"type":"string"},"body_format":{"type":"string"},"language":{"type":"string"},"detected_language":{"type":["string","null"]},"translation_group_id":{"type":["string","null"]},"is_translation_of":{"type":["string","null"]},"status":{"type":"string"},"source":{"type":"string"},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"reasoning":{"type":["string","null"]},"recipient":{"type":"object","properties":{"name":{"type":["string","null"]},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"language":{"type":["string","null"]},"source":{"type":["string","null"]},"contact_id":{"type":["string","null"]},"account_id":{"type":["string","null"]},"relationship":{"type":["string","null"]}},"required":["name","email","phone","language","source","contact_id","account_id","relationship"]},"lineage_id":{"type":"string"},"variant_label":{"type":["string","null"]},"superseded_by":{"type":["string","null"]},"superseded_at":{"type":["integer","null"]},"conversation_id":{"type":["string","null"]},"message_id":{"type":["string","null"]},"voice_note_recall_chunk_id":{"type":["string","null"]},"r2_key":{"type":["string","null"]},"revisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"revision":{"type":"integer"},"subject":{"type":["string","null"]},"body":{"type":"string"},"content_hash":{"type":["string","null"]},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"tokens_used":{"type":["integer","null"]},"duration_ms":{"type":["integer","null"]},"guardrails_status":{"type":["string","null"]},"guardrails_notes":{"type":["string","null"]},"change_summary":{"type":["string","null"]},"change_reason":{"type":["string","null"]},"created_at":{"type":"integer"},"created_by":{"type":"string"}},"required":["id","draft_id","revision","subject","body","content_hash","ai_generated","ai_model","ai_prompt_module","tokens_used","duration_ms","guardrails_status","guardrails_notes","change_summary","change_reason","created_at","created_by"]}},"forward_log":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"action":{"type":"string"},"channel":{"type":["string","null"]},"external_id":{"type":["string","null"]},"external_url":{"type":["string","null"]},"ip_address":{"type":["string","null"]},"user_agent":{"type":["string","null"]},"geolocation":{"type":["string","null"]},"session_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"inbound_from_email":{"type":["string","null"]},"inbound_from_phone":{"type":["string","null"]},"inbound_body":{"type":["string","null"]},"inbound_language":{"type":["string","null"]},"inbound_translated_body":{"type":["string","null"]},"metadata":{"type":["object","null"],"additionalProperties":{}},"created_at":{"type":"integer"}},"required":["id","draft_id","organization_id","user_id","action","channel","external_id","external_url","ip_address","user_agent","geolocation","session_id","request_id","inbound_from_email","inbound_from_phone","inbound_body","inbound_language","inbound_translated_body","metadata","created_at"]}},"forward_count":{"type":"integer"},"view_count":{"type":"integer"},"last_forwarded_at":{"type":["integer","null"]},"last_forwarded_via":{"type":["string","null"]},"has_inbound_reply":{"type":"boolean"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"created_by":{"type":"string"},"archived_at":{"type":["integer","null"]}},"required":["id","organization_id","user_id","context_type","context_id","context_data","kind","title","subject","body","body_format","language","detected_language","translation_group_id","is_translation_of","status","source","ai_generated","ai_model","ai_prompt_module","reasoning","recipient","lineage_id","variant_label","superseded_by","superseded_at","conversation_id","message_id","voice_note_recall_chunk_id","r2_key","created_at","updated_at","created_by","archived_at"]}},"total":{"type":"integer"}},"required":["drafts","total"]}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/outbox/drafts/{id}":{"get":{"tags":["Outbox: Drafts"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Draft with revisions + forward log","content":{"application/json":{"schema":{"type":"object","properties":{"draft":{"type":"object","properties":{"id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"context_type":{"type":"string"},"context_id":{"type":["string","null"]},"context_data":{"type":["object","null"],"additionalProperties":{}},"kind":{"type":"string"},"title":{"type":["string","null"]},"subject":{"type":["string","null"]},"body":{"type":"string"},"body_format":{"type":"string"},"language":{"type":"string"},"detected_language":{"type":["string","null"]},"translation_group_id":{"type":["string","null"]},"is_translation_of":{"type":["string","null"]},"status":{"type":"string"},"source":{"type":"string"},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"reasoning":{"type":["string","null"]},"recipient":{"type":"object","properties":{"name":{"type":["string","null"]},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"language":{"type":["string","null"]},"source":{"type":["string","null"]},"contact_id":{"type":["string","null"]},"account_id":{"type":["string","null"]},"relationship":{"type":["string","null"]}},"required":["name","email","phone","language","source","contact_id","account_id","relationship"]},"lineage_id":{"type":"string"},"variant_label":{"type":["string","null"]},"superseded_by":{"type":["string","null"]},"superseded_at":{"type":["integer","null"]},"conversation_id":{"type":["string","null"]},"message_id":{"type":["string","null"]},"voice_note_recall_chunk_id":{"type":["string","null"]},"r2_key":{"type":["string","null"]},"revisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"revision":{"type":"integer"},"subject":{"type":["string","null"]},"body":{"type":"string"},"content_hash":{"type":["string","null"]},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"tokens_used":{"type":["integer","null"]},"duration_ms":{"type":["integer","null"]},"guardrails_status":{"type":["string","null"]},"guardrails_notes":{"type":["string","null"]},"change_summary":{"type":["string","null"]},"change_reason":{"type":["string","null"]},"created_at":{"type":"integer"},"created_by":{"type":"string"}},"required":["id","draft_id","revision","subject","body","content_hash","ai_generated","ai_model","ai_prompt_module","tokens_used","duration_ms","guardrails_status","guardrails_notes","change_summary","change_reason","created_at","created_by"]}},"forward_log":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"action":{"type":"string"},"channel":{"type":["string","null"]},"external_id":{"type":["string","null"]},"external_url":{"type":["string","null"]},"ip_address":{"type":["string","null"]},"user_agent":{"type":["string","null"]},"geolocation":{"type":["string","null"]},"session_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"inbound_from_email":{"type":["string","null"]},"inbound_from_phone":{"type":["string","null"]},"inbound_body":{"type":["string","null"]},"inbound_language":{"type":["string","null"]},"inbound_translated_body":{"type":["string","null"]},"metadata":{"type":["object","null"],"additionalProperties":{}},"created_at":{"type":"integer"}},"required":["id","draft_id","organization_id","user_id","action","channel","external_id","external_url","ip_address","user_agent","geolocation","session_id","request_id","inbound_from_email","inbound_from_phone","inbound_body","inbound_language","inbound_translated_body","metadata","created_at"]}},"forward_count":{"type":"integer"},"view_count":{"type":"integer"},"last_forwarded_at":{"type":["integer","null"]},"last_forwarded_via":{"type":["string","null"]},"has_inbound_reply":{"type":"boolean"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"created_by":{"type":"string"},"archived_at":{"type":["integer","null"]}},"required":["id","organization_id","user_id","context_type","context_id","context_data","kind","title","subject","body","body_format","language","detected_language","translation_group_id","is_translation_of","status","source","ai_generated","ai_model","ai_prompt_module","reasoning","recipient","lineage_id","variant_label","superseded_by","superseded_at","conversation_id","message_id","voice_note_recall_chunk_id","r2_key","created_at","updated_at","created_by","archived_at"]}},"required":["draft"]}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"patch":{"tags":["Outbox: Drafts"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"description":"Fields to edit","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string","maxLength":500},"body":{"type":"string","minLength":1},"status":{"type":"string","enum":["draft","ready","archived"]},"language":{"type":"string","enum":["en","es","fr","de","pt","ja","zh","ko"]},"recipient_email":{"type":"string"},"recipient_phone":{"type":"string"},"recipient_name":{"type":"string"}}}}}},"responses":{"200":{"description":"Updated draft (new revision when body/subject changed)","content":{"application/json":{"schema":{"type":"object","properties":{"draft":{"type":"object","properties":{"id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"context_type":{"type":"string"},"context_id":{"type":["string","null"]},"context_data":{"type":["object","null"],"additionalProperties":{}},"kind":{"type":"string"},"title":{"type":["string","null"]},"subject":{"type":["string","null"]},"body":{"type":"string"},"body_format":{"type":"string"},"language":{"type":"string"},"detected_language":{"type":["string","null"]},"translation_group_id":{"type":["string","null"]},"is_translation_of":{"type":["string","null"]},"status":{"type":"string"},"source":{"type":"string"},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"reasoning":{"type":["string","null"]},"recipient":{"type":"object","properties":{"name":{"type":["string","null"]},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"language":{"type":["string","null"]},"source":{"type":["string","null"]},"contact_id":{"type":["string","null"]},"account_id":{"type":["string","null"]},"relationship":{"type":["string","null"]}},"required":["name","email","phone","language","source","contact_id","account_id","relationship"]},"lineage_id":{"type":"string"},"variant_label":{"type":["string","null"]},"superseded_by":{"type":["string","null"]},"superseded_at":{"type":["integer","null"]},"conversation_id":{"type":["string","null"]},"message_id":{"type":["string","null"]},"voice_note_recall_chunk_id":{"type":["string","null"]},"r2_key":{"type":["string","null"]},"revisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"revision":{"type":"integer"},"subject":{"type":["string","null"]},"body":{"type":"string"},"content_hash":{"type":["string","null"]},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"tokens_used":{"type":["integer","null"]},"duration_ms":{"type":["integer","null"]},"guardrails_status":{"type":["string","null"]},"guardrails_notes":{"type":["string","null"]},"change_summary":{"type":["string","null"]},"change_reason":{"type":["string","null"]},"created_at":{"type":"integer"},"created_by":{"type":"string"}},"required":["id","draft_id","revision","subject","body","content_hash","ai_generated","ai_model","ai_prompt_module","tokens_used","duration_ms","guardrails_status","guardrails_notes","change_summary","change_reason","created_at","created_by"]}},"forward_log":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"action":{"type":"string"},"channel":{"type":["string","null"]},"external_id":{"type":["string","null"]},"external_url":{"type":["string","null"]},"ip_address":{"type":["string","null"]},"user_agent":{"type":["string","null"]},"geolocation":{"type":["string","null"]},"session_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"inbound_from_email":{"type":["string","null"]},"inbound_from_phone":{"type":["string","null"]},"inbound_body":{"type":["string","null"]},"inbound_language":{"type":["string","null"]},"inbound_translated_body":{"type":["string","null"]},"metadata":{"type":["object","null"],"additionalProperties":{}},"created_at":{"type":"integer"}},"required":["id","draft_id","organization_id","user_id","action","channel","external_id","external_url","ip_address","user_agent","geolocation","session_id","request_id","inbound_from_email","inbound_from_phone","inbound_body","inbound_language","inbound_translated_body","metadata","created_at"]}},"forward_count":{"type":"integer"},"view_count":{"type":"integer"},"last_forwarded_at":{"type":["integer","null"]},"last_forwarded_via":{"type":["string","null"]},"has_inbound_reply":{"type":"boolean"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"created_by":{"type":"string"},"archived_at":{"type":["integer","null"]}},"required":["id","organization_id","user_id","context_type","context_id","context_data","kind","title","subject","body","body_format","language","detected_language","translation_group_id","is_translation_of","status","source","ai_generated","ai_model","ai_prompt_module","reasoning","recipient","lineage_id","variant_label","superseded_by","superseded_at","conversation_id","message_id","voice_note_recall_chunk_id","r2_key","created_at","updated_at","created_by","archived_at"]},"revision":{"type":["object","null"],"properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"revision":{"type":"integer"},"subject":{"type":["string","null"]},"body":{"type":"string"},"content_hash":{"type":["string","null"]},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"tokens_used":{"type":["integer","null"]},"duration_ms":{"type":["integer","null"]},"guardrails_status":{"type":["string","null"]},"guardrails_notes":{"type":["string","null"]},"change_summary":{"type":["string","null"]},"change_reason":{"type":["string","null"]},"created_at":{"type":"integer"},"created_by":{"type":"string"}},"required":["id","draft_id","revision","subject","body","content_hash","ai_generated","ai_model","ai_prompt_module","tokens_used","duration_ms","guardrails_status","guardrails_notes","change_summary","change_reason","created_at","created_by"]}},"required":["draft","revision"]}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/outbox/drafts/{id}/revise":{"post":{"tags":["Outbox: Drafts"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"description":"Revision hint","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hint":{"type":"string","maxLength":2000},"variant_label":{"type":"string"}}}}}},"responses":{"200":{"description":"Revised draft (AI-composed revision)","content":{"application/json":{"schema":{"type":"object","properties":{"draft":{"type":"object","properties":{"id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"context_type":{"type":"string"},"context_id":{"type":["string","null"]},"context_data":{"type":["object","null"],"additionalProperties":{}},"kind":{"type":"string"},"title":{"type":["string","null"]},"subject":{"type":["string","null"]},"body":{"type":"string"},"body_format":{"type":"string"},"language":{"type":"string"},"detected_language":{"type":["string","null"]},"translation_group_id":{"type":["string","null"]},"is_translation_of":{"type":["string","null"]},"status":{"type":"string"},"source":{"type":"string"},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"reasoning":{"type":["string","null"]},"recipient":{"type":"object","properties":{"name":{"type":["string","null"]},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"language":{"type":["string","null"]},"source":{"type":["string","null"]},"contact_id":{"type":["string","null"]},"account_id":{"type":["string","null"]},"relationship":{"type":["string","null"]}},"required":["name","email","phone","language","source","contact_id","account_id","relationship"]},"lineage_id":{"type":"string"},"variant_label":{"type":["string","null"]},"superseded_by":{"type":["string","null"]},"superseded_at":{"type":["integer","null"]},"conversation_id":{"type":["string","null"]},"message_id":{"type":["string","null"]},"voice_note_recall_chunk_id":{"type":["string","null"]},"r2_key":{"type":["string","null"]},"revisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"revision":{"type":"integer"},"subject":{"type":["string","null"]},"body":{"type":"string"},"content_hash":{"type":["string","null"]},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"tokens_used":{"type":["integer","null"]},"duration_ms":{"type":["integer","null"]},"guardrails_status":{"type":["string","null"]},"guardrails_notes":{"type":["string","null"]},"change_summary":{"type":["string","null"]},"change_reason":{"type":["string","null"]},"created_at":{"type":"integer"},"created_by":{"type":"string"}},"required":["id","draft_id","revision","subject","body","content_hash","ai_generated","ai_model","ai_prompt_module","tokens_used","duration_ms","guardrails_status","guardrails_notes","change_summary","change_reason","created_at","created_by"]}},"forward_log":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"action":{"type":"string"},"channel":{"type":["string","null"]},"external_id":{"type":["string","null"]},"external_url":{"type":["string","null"]},"ip_address":{"type":["string","null"]},"user_agent":{"type":["string","null"]},"geolocation":{"type":["string","null"]},"session_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"inbound_from_email":{"type":["string","null"]},"inbound_from_phone":{"type":["string","null"]},"inbound_body":{"type":["string","null"]},"inbound_language":{"type":["string","null"]},"inbound_translated_body":{"type":["string","null"]},"metadata":{"type":["object","null"],"additionalProperties":{}},"created_at":{"type":"integer"}},"required":["id","draft_id","organization_id","user_id","action","channel","external_id","external_url","ip_address","user_agent","geolocation","session_id","request_id","inbound_from_email","inbound_from_phone","inbound_body","inbound_language","inbound_translated_body","metadata","created_at"]}},"forward_count":{"type":"integer"},"view_count":{"type":"integer"},"last_forwarded_at":{"type":["integer","null"]},"last_forwarded_via":{"type":["string","null"]},"has_inbound_reply":{"type":"boolean"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"created_by":{"type":"string"},"archived_at":{"type":["integer","null"]}},"required":["id","organization_id","user_id","context_type","context_id","context_data","kind","title","subject","body","body_format","language","detected_language","translation_group_id","is_translation_of","status","source","ai_generated","ai_model","ai_prompt_module","reasoning","recipient","lineage_id","variant_label","superseded_by","superseded_at","conversation_id","message_id","voice_note_recall_chunk_id","r2_key","created_at","updated_at","created_by","archived_at"]},"revision":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"revision":{"type":"integer"},"subject":{"type":["string","null"]},"body":{"type":"string"},"content_hash":{"type":["string","null"]},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"tokens_used":{"type":["integer","null"]},"duration_ms":{"type":["integer","null"]},"guardrails_status":{"type":["string","null"]},"guardrails_notes":{"type":["string","null"]},"change_summary":{"type":["string","null"]},"change_reason":{"type":["string","null"]},"created_at":{"type":"integer"},"created_by":{"type":"string"}},"required":["id","draft_id","revision","subject","body","content_hash","ai_generated","ai_model","ai_prompt_module","tokens_used","duration_ms","guardrails_status","guardrails_notes","change_summary","change_reason","created_at","created_by"]}},"required":["draft","revision"]}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/outbox/drafts/{id}/translate":{"post":{"tags":["Outbox: Drafts"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"description":"Target language","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target_language":{"type":"string","enum":["en","es","fr","de","pt","ja","zh","ko"]},"force":{"type":"boolean"}},"required":["target_language"]}}}},"responses":{"200":{"description":"New sibling translation draft","content":{"application/json":{"schema":{"type":"object","properties":{"draft":{"type":"object","properties":{"id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"context_type":{"type":"string"},"context_id":{"type":["string","null"]},"context_data":{"type":["object","null"],"additionalProperties":{}},"kind":{"type":"string"},"title":{"type":["string","null"]},"subject":{"type":["string","null"]},"body":{"type":"string"},"body_format":{"type":"string"},"language":{"type":"string"},"detected_language":{"type":["string","null"]},"translation_group_id":{"type":["string","null"]},"is_translation_of":{"type":["string","null"]},"status":{"type":"string"},"source":{"type":"string"},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"reasoning":{"type":["string","null"]},"recipient":{"type":"object","properties":{"name":{"type":["string","null"]},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"language":{"type":["string","null"]},"source":{"type":["string","null"]},"contact_id":{"type":["string","null"]},"account_id":{"type":["string","null"]},"relationship":{"type":["string","null"]}},"required":["name","email","phone","language","source","contact_id","account_id","relationship"]},"lineage_id":{"type":"string"},"variant_label":{"type":["string","null"]},"superseded_by":{"type":["string","null"]},"superseded_at":{"type":["integer","null"]},"conversation_id":{"type":["string","null"]},"message_id":{"type":["string","null"]},"voice_note_recall_chunk_id":{"type":["string","null"]},"r2_key":{"type":["string","null"]},"revisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"revision":{"type":"integer"},"subject":{"type":["string","null"]},"body":{"type":"string"},"content_hash":{"type":["string","null"]},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"tokens_used":{"type":["integer","null"]},"duration_ms":{"type":["integer","null"]},"guardrails_status":{"type":["string","null"]},"guardrails_notes":{"type":["string","null"]},"change_summary":{"type":["string","null"]},"change_reason":{"type":["string","null"]},"created_at":{"type":"integer"},"created_by":{"type":"string"}},"required":["id","draft_id","revision","subject","body","content_hash","ai_generated","ai_model","ai_prompt_module","tokens_used","duration_ms","guardrails_status","guardrails_notes","change_summary","change_reason","created_at","created_by"]}},"forward_log":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"action":{"type":"string"},"channel":{"type":["string","null"]},"external_id":{"type":["string","null"]},"external_url":{"type":["string","null"]},"ip_address":{"type":["string","null"]},"user_agent":{"type":["string","null"]},"geolocation":{"type":["string","null"]},"session_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"inbound_from_email":{"type":["string","null"]},"inbound_from_phone":{"type":["string","null"]},"inbound_body":{"type":["string","null"]},"inbound_language":{"type":["string","null"]},"inbound_translated_body":{"type":["string","null"]},"metadata":{"type":["object","null"],"additionalProperties":{}},"created_at":{"type":"integer"}},"required":["id","draft_id","organization_id","user_id","action","channel","external_id","external_url","ip_address","user_agent","geolocation","session_id","request_id","inbound_from_email","inbound_from_phone","inbound_body","inbound_language","inbound_translated_body","metadata","created_at"]}},"forward_count":{"type":"integer"},"view_count":{"type":"integer"},"last_forwarded_at":{"type":["integer","null"]},"last_forwarded_via":{"type":["string","null"]},"has_inbound_reply":{"type":"boolean"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"created_by":{"type":"string"},"archived_at":{"type":["integer","null"]}},"required":["id","organization_id","user_id","context_type","context_id","context_data","kind","title","subject","body","body_format","language","detected_language","translation_group_id","is_translation_of","status","source","ai_generated","ai_model","ai_prompt_module","reasoning","recipient","lineage_id","variant_label","superseded_by","superseded_at","conversation_id","message_id","voice_note_recall_chunk_id","r2_key","created_at","updated_at","created_by","archived_at"]},"source_draft_id":{"type":"string"},"translation_cost_cents":{"type":"integer"}},"required":["draft","source_draft_id"]}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/outbox/drafts/{id}/forward":{"post":{"tags":["Outbox: Drafts"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"description":"Forward action to log","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["copy","forward_email","forward_whatsapp","forward_sms","share","view","sent_server"]},"channel":{"type":"string"},"metadata":{"type":"object","additionalProperties":{}}},"required":["action"]}}}},"responses":{"200":{"description":"Forward event logged","content":{"application/json":{"schema":{"type":"object","properties":{"entry":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"action":{"type":"string"},"channel":{"type":["string","null"]},"external_id":{"type":["string","null"]},"external_url":{"type":["string","null"]},"ip_address":{"type":["string","null"]},"user_agent":{"type":["string","null"]},"geolocation":{"type":["string","null"]},"session_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"inbound_from_email":{"type":["string","null"]},"inbound_from_phone":{"type":["string","null"]},"inbound_body":{"type":["string","null"]},"inbound_language":{"type":["string","null"]},"inbound_translated_body":{"type":["string","null"]},"metadata":{"type":["object","null"],"additionalProperties":{}},"created_at":{"type":"integer"}},"required":["id","draft_id","organization_id","user_id","action","channel","external_id","external_url","ip_address","user_agent","geolocation","session_id","request_id","inbound_from_email","inbound_from_phone","inbound_body","inbound_language","inbound_translated_body","metadata","created_at"]}},"required":["entry"]}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/outbox/drafts/{id}/discard":{"post":{"tags":["Outbox: Drafts"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Draft soft-archived","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"draft":{"type":"object","properties":{"id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"context_type":{"type":"string"},"context_id":{"type":["string","null"]},"context_data":{"type":["object","null"],"additionalProperties":{}},"kind":{"type":"string"},"title":{"type":["string","null"]},"subject":{"type":["string","null"]},"body":{"type":"string"},"body_format":{"type":"string"},"language":{"type":"string"},"detected_language":{"type":["string","null"]},"translation_group_id":{"type":["string","null"]},"is_translation_of":{"type":["string","null"]},"status":{"type":"string"},"source":{"type":"string"},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"reasoning":{"type":["string","null"]},"recipient":{"type":"object","properties":{"name":{"type":["string","null"]},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"language":{"type":["string","null"]},"source":{"type":["string","null"]},"contact_id":{"type":["string","null"]},"account_id":{"type":["string","null"]},"relationship":{"type":["string","null"]}},"required":["name","email","phone","language","source","contact_id","account_id","relationship"]},"lineage_id":{"type":"string"},"variant_label":{"type":["string","null"]},"superseded_by":{"type":["string","null"]},"superseded_at":{"type":["integer","null"]},"conversation_id":{"type":["string","null"]},"message_id":{"type":["string","null"]},"voice_note_recall_chunk_id":{"type":["string","null"]},"r2_key":{"type":["string","null"]},"revisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"revision":{"type":"integer"},"subject":{"type":["string","null"]},"body":{"type":"string"},"content_hash":{"type":["string","null"]},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"tokens_used":{"type":["integer","null"]},"duration_ms":{"type":["integer","null"]},"guardrails_status":{"type":["string","null"]},"guardrails_notes":{"type":["string","null"]},"change_summary":{"type":["string","null"]},"change_reason":{"type":["string","null"]},"created_at":{"type":"integer"},"created_by":{"type":"string"}},"required":["id","draft_id","revision","subject","body","content_hash","ai_generated","ai_model","ai_prompt_module","tokens_used","duration_ms","guardrails_status","guardrails_notes","change_summary","change_reason","created_at","created_by"]}},"forward_log":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"action":{"type":"string"},"channel":{"type":["string","null"]},"external_id":{"type":["string","null"]},"external_url":{"type":["string","null"]},"ip_address":{"type":["string","null"]},"user_agent":{"type":["string","null"]},"geolocation":{"type":["string","null"]},"session_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"inbound_from_email":{"type":["string","null"]},"inbound_from_phone":{"type":["string","null"]},"inbound_body":{"type":["string","null"]},"inbound_language":{"type":["string","null"]},"inbound_translated_body":{"type":["string","null"]},"metadata":{"type":["object","null"],"additionalProperties":{}},"created_at":{"type":"integer"}},"required":["id","draft_id","organization_id","user_id","action","channel","external_id","external_url","ip_address","user_agent","geolocation","session_id","request_id","inbound_from_email","inbound_from_phone","inbound_body","inbound_language","inbound_translated_body","metadata","created_at"]}},"forward_count":{"type":"integer"},"view_count":{"type":"integer"},"last_forwarded_at":{"type":["integer","null"]},"last_forwarded_via":{"type":["string","null"]},"has_inbound_reply":{"type":"boolean"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"created_by":{"type":"string"},"archived_at":{"type":["integer","null"]}},"required":["id","organization_id","user_id","context_type","context_id","context_data","kind","title","subject","body","body_format","language","detected_language","translation_group_id","is_translation_of","status","source","ai_generated","ai_model","ai_prompt_module","reasoning","recipient","lineage_id","variant_label","superseded_by","superseded_at","conversation_id","message_id","voice_note_recall_chunk_id","r2_key","created_at","updated_at","created_by","archived_at"]}},"required":["success","draft"]}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/outbox/preferences":{"get":{"tags":["Outbox: Preferences"],"responses":{"200":{"description":"Org outbox preferences (created on first read)","content":{"application/json":{"schema":{"type":"object","properties":{"organization_id":{"type":"string"},"auto_translate_enabled":{"type":"boolean"},"auto_translate_monthly_budget_cents":{"type":["integer","null"]},"default_outbound_language":{"type":"string"},"spent_this_month_cents":{"type":"integer"},"translations_this_month":{"type":"integer"},"budget_remaining_cents":{"type":["integer","null"]},"created_at":{"type":"integer"},"updated_at":{"type":"integer"}},"required":["organization_id","auto_translate_enabled","auto_translate_monthly_budget_cents","default_outbound_language","spent_this_month_cents","translations_this_month","budget_remaining_cents","created_at","updated_at"]}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"patch":{"tags":["Outbox: Preferences"],"requestBody":{"description":"Partial preference update","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"auto_translate_enabled":{"type":"boolean"},"auto_translate_monthly_budget_cents":{"type":["integer","null"]},"default_outbound_language":{"type":"string","enum":["en","es","fr","de","pt","ja","zh","ko"]}}}}}},"responses":{"200":{"description":"Updated org outbox preferences","content":{"application/json":{"schema":{"type":"object","properties":{"organization_id":{"type":"string"},"auto_translate_enabled":{"type":"boolean"},"auto_translate_monthly_budget_cents":{"type":["integer","null"]},"default_outbound_language":{"type":"string"},"spent_this_month_cents":{"type":"integer"},"translations_this_month":{"type":"integer"},"budget_remaining_cents":{"type":["integer","null"]},"created_at":{"type":"integer"},"updated_at":{"type":"integer"}},"required":["organization_id","auto_translate_enabled","auto_translate_monthly_budget_cents","default_outbound_language","spent_this_month_cents","translations_this_month","budget_remaining_cents","created_at","updated_at"]}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/internal/outbox/emit-draft":{"post":{"tags":["Outbox: Internal"],"requestBody":{"description":"Draft to emit","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"context_type":{"type":"string","enum":["engagement","crm_deal","crm_contact","calendar_event","proposal","standalone","brand_commander_post"]},"context_id":{"type":"string"},"context_data":{"type":"object","additionalProperties":{}},"kind":{"type":"string","enum":["email","whatsapp","sms","note","linkedin","slack_dm","telegram"]},"title":{"type":"string","maxLength":300},"subject":{"type":"string","maxLength":500},"body":{"type":"string","minLength":1},"body_format":{"type":"string","enum":["markdown","html","plain"]},"language":{"type":"string","enum":["en","es","fr","de","pt","ja","zh","ko"]},"source":{"type":"string","enum":["manual","ai_composed","voice_note","template"]},"ai_model":{"type":"string"},"ai_prompt":{"type":"string"},"ai_prompt_module":{"type":"string"},"tokens_used":{"type":"integer"},"duration_ms":{"type":"integer"},"reasoning":{"type":"string"},"recipient_hint":{"type":"string"},"conversation_id":{"type":"string"},"message_id":{"type":"string"},"voice_note_recall_chunk_id":{"type":"string"},"variant_label":{"type":"string"}},"required":["context_type","kind","body"]}}}},"responses":{"201":{"description":"Draft created with revision 1","content":{"application/json":{"schema":{"type":"object","properties":{"draft":{"type":"object","properties":{"id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"context_type":{"type":"string"},"context_id":{"type":["string","null"]},"context_data":{"type":["object","null"],"additionalProperties":{}},"kind":{"type":"string"},"title":{"type":["string","null"]},"subject":{"type":["string","null"]},"body":{"type":"string"},"body_format":{"type":"string"},"language":{"type":"string"},"detected_language":{"type":["string","null"]},"translation_group_id":{"type":["string","null"]},"is_translation_of":{"type":["string","null"]},"status":{"type":"string"},"source":{"type":"string"},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"reasoning":{"type":["string","null"]},"recipient":{"type":"object","properties":{"name":{"type":["string","null"]},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"language":{"type":["string","null"]},"source":{"type":["string","null"]},"contact_id":{"type":["string","null"]},"account_id":{"type":["string","null"]},"relationship":{"type":["string","null"]}},"required":["name","email","phone","language","source","contact_id","account_id","relationship"]},"lineage_id":{"type":"string"},"variant_label":{"type":["string","null"]},"superseded_by":{"type":["string","null"]},"superseded_at":{"type":["integer","null"]},"conversation_id":{"type":["string","null"]},"message_id":{"type":["string","null"]},"voice_note_recall_chunk_id":{"type":["string","null"]},"r2_key":{"type":["string","null"]},"revisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"revision":{"type":"integer"},"subject":{"type":["string","null"]},"body":{"type":"string"},"content_hash":{"type":["string","null"]},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"tokens_used":{"type":["integer","null"]},"duration_ms":{"type":["integer","null"]},"guardrails_status":{"type":["string","null"]},"guardrails_notes":{"type":["string","null"]},"change_summary":{"type":["string","null"]},"change_reason":{"type":["string","null"]},"created_at":{"type":"integer"},"created_by":{"type":"string"}},"required":["id","draft_id","revision","subject","body","content_hash","ai_generated","ai_model","ai_prompt_module","tokens_used","duration_ms","guardrails_status","guardrails_notes","change_summary","change_reason","created_at","created_by"]}},"forward_log":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"action":{"type":"string"},"channel":{"type":["string","null"]},"external_id":{"type":["string","null"]},"external_url":{"type":["string","null"]},"ip_address":{"type":["string","null"]},"user_agent":{"type":["string","null"]},"geolocation":{"type":["string","null"]},"session_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"inbound_from_email":{"type":["string","null"]},"inbound_from_phone":{"type":["string","null"]},"inbound_body":{"type":["string","null"]},"inbound_language":{"type":["string","null"]},"inbound_translated_body":{"type":["string","null"]},"metadata":{"type":["object","null"],"additionalProperties":{}},"created_at":{"type":"integer"}},"required":["id","draft_id","organization_id","user_id","action","channel","external_id","external_url","ip_address","user_agent","geolocation","session_id","request_id","inbound_from_email","inbound_from_phone","inbound_body","inbound_language","inbound_translated_body","metadata","created_at"]}},"forward_count":{"type":"integer"},"view_count":{"type":"integer"},"last_forwarded_at":{"type":["integer","null"]},"last_forwarded_via":{"type":["string","null"]},"has_inbound_reply":{"type":"boolean"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"created_by":{"type":"string"},"archived_at":{"type":["integer","null"]}},"required":["id","organization_id","user_id","context_type","context_id","context_data","kind","title","subject","body","body_format","language","detected_language","translation_group_id","is_translation_of","status","source","ai_generated","ai_model","ai_prompt_module","reasoning","recipient","lineage_id","variant_label","superseded_by","superseded_at","conversation_id","message_id","voice_note_recall_chunk_id","r2_key","created_at","updated_at","created_by","archived_at"]},"revision":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"revision":{"type":"integer"},"subject":{"type":["string","null"]},"body":{"type":"string"},"content_hash":{"type":["string","null"]},"ai_generated":{"type":"boolean"},"ai_model":{"type":["string","null"]},"ai_prompt_module":{"type":["string","null"]},"tokens_used":{"type":["integer","null"]},"duration_ms":{"type":["integer","null"]},"guardrails_status":{"type":["string","null"]},"guardrails_notes":{"type":["string","null"]},"change_summary":{"type":["string","null"]},"change_reason":{"type":["string","null"]},"created_at":{"type":"integer"},"created_by":{"type":"string"}},"required":["id","draft_id","revision","subject","body","content_hash","ai_generated","ai_model","ai_prompt_module","tokens_used","duration_ms","guardrails_status","guardrails_notes","change_summary","change_reason","created_at","created_by"]}},"required":["draft","revision"]}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/v1/internal/outbox/inbound-reply":{"post":{"tags":["Outbox: Internal"],"requestBody":{"description":"Inbound reply to record","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"draft_id":{"type":"string"},"context_type":{"type":"string","enum":["engagement","crm_deal","crm_contact","calendar_event","proposal","standalone","brand_commander_post"]},"context_id":{"type":"string"},"from_email":{"type":"string"},"from_phone":{"type":"string"},"body":{"type":"string","minLength":1},"received_at":{"type":"integer"},"metadata":{"type":"object","additionalProperties":{}}},"required":["body"]}}}},"responses":{"200":{"description":"Reply recorded against a draft","content":{"application/json":{"schema":{"type":"object","properties":{"forward_log_entry":{"type":"object","properties":{"id":{"type":"string"},"draft_id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"action":{"type":"string"},"channel":{"type":["string","null"]},"external_id":{"type":["string","null"]},"external_url":{"type":["string","null"]},"ip_address":{"type":["string","null"]},"user_agent":{"type":["string","null"]},"geolocation":{"type":["string","null"]},"session_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"inbound_from_email":{"type":["string","null"]},"inbound_from_phone":{"type":["string","null"]},"inbound_body":{"type":["string","null"]},"inbound_language":{"type":["string","null"]},"inbound_translated_body":{"type":["string","null"]},"metadata":{"type":["object","null"],"additionalProperties":{}},"created_at":{"type":"integer"}},"required":["id","draft_id","organization_id","user_id","action","channel","external_id","external_url","ip_address","user_agent","geolocation","session_id","request_id","inbound_from_email","inbound_from_phone","inbound_body","inbound_language","inbound_translated_body","metadata","created_at"]},"matched_draft_id":{"type":["string","null"]}},"required":["forward_log_entry","matched_draft_id"]}}}},"401":{"description":"Not authenticated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"webhooks":{}}