{"openapi":"3.1.0","info":{"title":"Email Manager API","version":"1.0.0","description":"Subset of live /v1 routes on Email Manager. Full desk contract: GET /actions. Implementation: v1Dispatch."},"servers":[{"url":"https://mail-api.cloudcrew.si"}],"paths":{"/v1/health":{"get":{"operationId":"health","summary":"Workspace mail setup and delivery mode","security":[{"bearerEm":[]}],"responses":{"200":{"description":"Health","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}}}}},"/v1/stats":{"get":{"operationId":"stats","summary":"Send and delivery counters","security":[{"bearerEm":[]}],"responses":{"200":{"description":"Stats","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Stats"}}}}}}},"/v1/emails":{"get":{"operationId":"listEmails","summary":"List or search messages","security":[{"bearerEm":[]}],"parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":30}},{"name":"forEmployee","in":"query","schema":{"type":"string"}},{"name":"label","in":"query","schema":{"type":"string"}},{"name":"delivery","in":"query","schema":{"type":"string","enum":["held","sent","bounced","complained","failed"]}},{"name":"group","in":"query","schema":{"type":"string","enum":["thread","threads"]}}],"responses":{"200":{"description":"Message list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageList"}}}}}},"post":{"operationId":"sendEmail","summary":"Send one message or render a template","security":[{"bearerEm":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendEmail"}}}},"responses":{"200":{"description":"Sent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendReceipt"}}}},"201":{"description":"Scheduled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduledSend"}}}},"422":{"description":"Rejected","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}}}},"/v1/emails/batch":{"post":{"operationId":"sendBatch","summary":"Send up to 10 messages","security":[{"bearerEm":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"emails":{"type":"array","items":{"$ref":"#/components/schemas/SendEmail"},"maxItems":10}},"required":["emails"]}}}},"responses":{"200":{"description":"Batch result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchSend"}}}}}}},"/v1/emails/{id}":{"get":{"operationId":"getEmail","summary":"One message","security":[{"bearerEm":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Message","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}}}},"/v1/domains":{"get":{"operationId":"listDomains","summary":"Sending domains","security":[{"bearerEm":[]}],"responses":{"200":{"description":"Domains","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainList"}}}}}},"post":{"operationId":"addDomain","summary":"Add a domain","security":[{"bearerEm":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}}}},"responses":{"201":{"description":"Domain","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Domain"}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}}}},"/v1/domains/verify":{"post":{"operationId":"verifyDomain","summary":"Check DKIM DNS","security":[{"bearerEm":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}}}},"responses":{"200":{"description":"Domain status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Domain"}}}}}}},"/v1/api-keys":{"get":{"operationId":"listApiKeys","summary":"List API keys (no secrets)","security":[{"bearerEm":[]}],"responses":{"200":{"description":"Keys","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyList"}}}}}},"post":{"operationId":"createApiKey","summary":"Create key (secret returned once)","security":[{"bearerEm":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"domain":{"type":"string","nullable":true}}}}}},"responses":{"201":{"description":"New key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreated"}}}}}}},"/v1/audiences":{"get":{"operationId":"listAudiences","security":[{"bearerEm":[]}],"responses":{"200":{"description":"Audiences","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceList"}}}}}},"post":{"operationId":"createAudience","security":[{"bearerEm":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"id":{"type":"string"}},"required":["name"]}}}},"responses":{"201":{"description":"Audience","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Audience"}}}}}}},"/v1/audiences/{id}/contacts":{"post":{"operationId":"addAudienceContacts","security":[{"bearerEm":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"emails":{"type":"array","items":{"type":"string"}},"defaultTags":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"201":{"description":"Member","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceMember"}}}}}}},"/v1/contacts":{"get":{"operationId":"listContacts","security":[{"bearerEm":[]}],"parameters":[{"name":"tag","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Contacts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactList"}}}}}},"post":{"operationId":"upsertContact","security":[{"bearerEm":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"required":["email"]}}}},"responses":{"201":{"description":"Contact","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Contact"}}}}}}},"/v1/broadcasts":{"get":{"operationId":"listBroadcasts","security":[{"bearerEm":[]}],"responses":{"200":{"description":"Broadcasts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BroadcastList"}}}}}},"post":{"operationId":"saveBroadcast","security":[{"bearerEm":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BroadcastDraft"}}}},"responses":{"201":{"description":"Broadcast","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Broadcast"}}}}}}},"/v1/broadcasts/{id}/send":{"post":{"operationId":"sendBroadcast","security":[{"bearerEm":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Send started","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BroadcastSend"}}}}}}},"/v1/webhooks":{"get":{"operationId":"listWebhooks","security":[{"bearerEm":[]}],"responses":{"200":{"description":"Webhooks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookList"}}}}}},"post":{"operationId":"createWebhook","security":[{"bearerEm":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]}}}},"responses":{"201":{"description":"Webhook","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook"}}}}}}},"/v1/suppression":{"get":{"operationId":"listSuppressions","security":[{"bearerEm":[]}],"responses":{"200":{"description":"Suppressions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuppressionList"}}}}}},"post":{"operationId":"suppressEmail","security":[{"bearerEm":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"]}}}},"responses":{"201":{"description":"Suppressed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Suppression"}}}}}}},"/public/deliverability":{"get":{"operationId":"publicDeliverability","summary":"Public pipe posture (no org data)","security":[],"responses":{"200":{"description":"Deliverability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deliverability"}}}}}}},"/mcp":{"post":{"operationId":"mcp","summary":"Model Context Protocol","description":"Bearer em_… (host key) or alk_… (identity connector → employee JWT).","security":[{"bearerEm":[]},{"bearerAlk":[]}],"responses":{"200":{"description":"JSON-RPC MCP response"}}}}},"components":{"securitySchemes":{"bearerEm":{"type":"http","scheme":"bearer","bearerFormat":"em_","description":"Org API key from Email Manager desk (prefix em_)."},"bearerAlk":{"type":"http","scheme":"bearer","bearerFormat":"alk_","description":"Identity vault connector key."}},"schemas":{"ErrorMessage":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},"Health":{"type":"object","properties":{"object":{"type":"string","const":"health"},"delivery":{"type":"string","enum":["ses","held"]},"status":{"type":"string"},"note":{"type":"string"},"setup":{"type":"object","additionalProperties":true}}},"Stats":{"type":"object","properties":{"object":{"type":"string"},"sent24h":{"type":"integer"}},"additionalProperties":true},"SendEmail":{"type":"object","properties":{"from":{"type":"string"},"to":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"subject":{"type":"string"},"text":{"type":"string"},"html":{"type":"string"},"template":{"type":"string"},"vars":{"type":"object","additionalProperties":{"type":"string"}},"scheduledAt":{"type":"integer","description":"Unix ms"}}},"SendReceipt":{"type":"object","properties":{"id":{"type":"string"},"delivery":{"type":"string"}},"required":["id","delivery"]},"ScheduledSend":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"scheduledAt":{"type":"integer"}}},"MessageList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Message"}}}},"Message":{"type":"object","additionalProperties":true},"BatchSend":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SendReceipt"}},"errors":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"message":{"type":"string"}}}}}},"DomainList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Domain"}}}},"Domain":{"type":"object","properties":{"name":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"ApiKeyList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ApiKey"}}}},"ApiKey":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"domain":{"type":"string","nullable":true}}},"ApiKeyCreated":{"type":"object","properties":{"id":{"type":"string"},"prefix":{"type":"string"},"secret":{"type":"string"},"domain":{"type":"string","nullable":true}},"required":["id","prefix","secret"]},"AudienceList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Audience"}}}},"Audience":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"AudienceMember":{"type":"object","additionalProperties":true},"ContactList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Contact"}}}},"Contact":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"name":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}}},"BroadcastList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Broadcast"}}}},"BroadcastDraft":{"type":"object","properties":{"name":{"type":"string"},"subject":{"type":"string"},"text":{"type":"string"},"audienceId":{"type":"string"},"segmentId":{"type":"string"},"scheduledAt":{"type":"integer"}},"required":["name","subject","audienceId"]},"Broadcast":{"type":"object","additionalProperties":true},"BroadcastSend":{"type":"object","additionalProperties":true},"WebhookList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Webhook"}}}},"Webhook":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"}}},"SuppressionList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Suppression"}}}},"Suppression":{"type":"object","properties":{"email":{"type":"string"}}},"Deliverability":{"type":"object","properties":{"product":{"type":"string"},"pipe":{"type":"string"},"amazon":{"type":"boolean"},"note":{"type":"string"}}}}}}