{"openapi":"3.1.0","info":{"title":"IG Reach API — ICOP","description":"Managed Instagram creator outreach platform — API-first, multi-tenant. HeyReach for Instagram.","version":"0.1.0"},"paths":{"/health":{"get":{"tags":["Health"],"summary":"Health Liveness","operationId":"health_liveness_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/ready":{"get":{"tags":["Health"],"summary":"Health Readiness","operationId":"health_readiness_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/health/fleet":{"get":{"tags":["Monitoring"],"summary":"Fleet Health","description":"Detailed fleet health: accounts, campaigns, webhook delivery stats.","operationId":"fleet_health_v1_health_fleet_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/health/readiness":{"get":{"tags":["Monitoring"],"summary":"Readiness","description":"Kubernetes-style readiness probe — returns 200 when DB + at least one active sender.","operationId":"readiness_v1_health_readiness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/campaigns":{"post":{"tags":["Campaigns"],"summary":"Create Campaign","operationId":"create_campaign_v1_campaigns_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignCreate"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Campaigns"],"summary":"List Campaigns","operationId":"list_campaigns_v1_campaigns_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CampaignResponse"},"title":"Response List Campaigns V1 Campaigns Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/campaigns/{campaign_id}":{"get":{"tags":["Campaigns"],"summary":"Get Campaign","operationId":"get_campaign_v1_campaigns__campaign_id__get","parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Campaigns"],"summary":"Cancel Campaign","operationId":"cancel_campaign_v1_campaigns__campaign_id__delete","parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/campaigns/{campaign_id}/targets":{"post":{"tags":["Campaigns"],"summary":"Add Targets","operationId":"add_targets_v1_campaigns__campaign_id__targets_post","parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TargetAdd"},"title":"Targets"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/campaigns/{campaign_id}/pause":{"post":{"tags":["Campaigns"],"summary":"Pause Campaign","operationId":"pause_campaign_v1_campaigns__campaign_id__pause_post","parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/campaigns/{campaign_id}/resume":{"post":{"tags":["Campaigns"],"summary":"Resume Campaign","operationId":"resume_campaign_v1_campaigns__campaign_id__resume_post","parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/campaigns/{campaign_id}/export":{"get":{"tags":["Campaigns"],"summary":"Export Campaign Csv","operationId":"export_campaign_csv_v1_campaigns__campaign_id__export_get","parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks":{"get":{"tags":["Webhooks"],"summary":"List Webhooks","operationId":"list_webhooks_v1_webhooks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/WebhookResponse"},"type":"array","title":"Response List Webhooks V1 Webhooks Get"}}}}}},"post":{"tags":["Webhooks"],"summary":"Register Webhook","operationId":"register_webhook_v1_webhooks_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookRegister"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/{webhook_id}":{"delete":{"tags":["Webhooks"],"summary":"Delete Webhook","operationId":"delete_webhook_v1_webhooks__webhook_id__delete","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Webhook Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accounts":{"get":{"tags":["Accounts"],"summary":"List Accounts","operationId":"list_accounts_v1_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/accounts/{account_id}":{"get":{"tags":["Accounts"],"summary":"Get Account","operationId":"get_account_v1_accounts__account_id__get","parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Account Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"CampaignCreate":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"targets":{"items":{"$ref":"#/components/schemas/TargetAdd"},"type":"array","maxItems":10000,"minItems":1,"title":"Targets"},"message_template":{"type":"string","maxLength":2000,"minLength":1,"title":"Message Template"},"template_vars":{"additionalProperties":true,"type":"object","title":"Template Vars"},"follow_up_template":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Follow Up Template"},"follow_up_delay_hours":{"type":"integer","maximum":720.0,"minimum":1.0,"title":"Follow Up Delay Hours","default":72},"max_dms_per_day":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Max Dms Per Day","default":40},"webhook_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Webhook Url"}},"type":"object","required":["name","targets","message_template"],"title":"CampaignCreate"},"CampaignResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"client_id":{"type":"string","format":"uuid","title":"Client Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"targets_total":{"type":"integer","title":"Targets Total","default":0},"targets_sent":{"type":"integer","title":"Targets Sent","default":0},"targets_failed":{"type":"integer","title":"Targets Failed","default":0},"targets_replied":{"type":"integer","title":"Targets Replied","default":0},"message_template":{"type":"string","title":"Message Template"},"follow_up_template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Follow Up Template"},"follow_up_delay_hours":{"type":"integer","title":"Follow Up Delay Hours","default":72},"max_dms_per_day":{"type":"integer","title":"Max Dms Per Day","default":40},"created_at":{"type":"string","format":"date-time","title":"Created At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"}},"type":"object","required":["id","client_id","name","status","message_template","created_at"],"title":"CampaignResponse"},"CampaignStatusResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"client_id":{"type":"string","format":"uuid","title":"Client Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"targets_total":{"type":"integer","title":"Targets Total","default":0},"targets_sent":{"type":"integer","title":"Targets Sent","default":0},"targets_failed":{"type":"integer","title":"Targets Failed","default":0},"targets_replied":{"type":"integer","title":"Targets Replied","default":0},"message_template":{"type":"string","title":"Message Template"},"follow_up_template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Follow Up Template"},"follow_up_delay_hours":{"type":"integer","title":"Follow Up Delay Hours","default":72},"max_dms_per_day":{"type":"integer","title":"Max Dms Per Day","default":40},"created_at":{"type":"string","format":"date-time","title":"Created At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"targets":{"items":{"$ref":"#/components/schemas/TargetStatusResponse"},"type":"array","title":"Targets","default":[]}},"type":"object","required":["id","client_id","name","status","message_template","created_at"],"title":"CampaignStatusResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"TargetAdd":{"properties":{"ig_username":{"type":"string","maxLength":255,"minLength":1,"title":"Ig Username"},"personalization":{"additionalProperties":true,"type":"object","title":"Personalization"}},"type":"object","required":["ig_username"],"title":"TargetAdd"},"TargetStatusResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"ig_username":{"type":"string","title":"Ig Username"},"ig_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ig User Id"},"status":{"type":"string","title":"Status"},"personalization":{"additionalProperties":true,"type":"object","title":"Personalization"},"error_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Reason"},"sender_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Sender Account Id"},"attempt_count":{"type":"integer","title":"Attempt Count","default":0},"sent_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Sent At"},"replied_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Replied At"}},"type":"object","required":["id","ig_username","status","personalization"],"title":"TargetStatusResponse"},"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"},"WebhookRegister":{"properties":{"url":{"type":"string","maxLength":2048,"title":"Url"},"secret":{"type":"string","maxLength":255,"minLength":8,"title":"Secret"},"events":{"items":{"type":"string"},"type":"array","title":"Events"}},"type":"object","required":["url","secret"],"title":"WebhookRegister"},"WebhookResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"is_active":{"type":"boolean","title":"Is Active","default":true},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","url","events","created_at"],"title":"WebhookResponse"}}},"servers":[{"url":"/icop/api"}]}