{"openapi":"3.1.0","info":{"title":"Mailers MTA Node API","version":"0.12.0","description":"Independent outbound processing node. Stages 0–12 launch-ready (sink); Internet MX gated. Not smtp.mailers.io ingress."},"servers":[{"url":"http://127.0.0.1:9080"}],"paths":{"/health":{"get":{"summary":"Health","responses":{"200":{"description":"OK"},"503":{"description":"Degraded"}}}},"/v1/api-keys":{"post":{"summary":"Create tenant-scoped API key (platform token)","security":[{"PlatformToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["tenant_uid"],"properties":{"tenant_uid":{"type":"string"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"201":{"description":"Created (api_key shown once)"}}}},"/v1/messages":{"post":{"summary":"Submit message (202 after durable accept)","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["from_email","recipients"],"properties":{"tenant_uid":{"type":"string","description":"Required for platform token; ignored/forced for scoped keys"},"from_email":{"type":"string","format":"email"},"subject":{"type":"string"},"text":{"type":"string"},"html":{"type":"string"},"recipients":{"type":"array","items":{"type":"string","format":"email"}},"stream":{"type":"string","enum":["transactional","marketing"]},"idempotency_key":{"type":"string"}}}}}},"responses":{"200":{"description":"Idempotent replay"},"202":{"description":"Accepted and queued"},"409":{"description":"Idempotency conflict"},"429":{"description":"Quota exceeded"}}}},"/v1/messages/{message_uid}":{"get":{"summary":"Message + recipients + events","security":[{"BearerAuth":[]}],"parameters":[{"name":"message_uid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"},"403":{"description":"Tenant isolation"}}}},"/v1/messages/{message_uid}/events":{"get":{"summary":"Event timeline","security":[{"BearerAuth":[]}],"parameters":[{"name":"message_uid","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK"}}}},"/v1/domains":{"get":{"summary":"List domains","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}},"post":{"summary":"Create domain","security":[{"BearerAuth":[]}],"responses":{"201":{"description":"Created"}}}},"/v1/reconcile":{"post":{"summary":"Run ledger/outbox reconciliation (platform)","security":[{"PlatformToken":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/safety/health":{"get":{"summary":"Safety scanner health","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"},"503":{"description":"Scanner degraded"}}}},"/v1/safety/quarantine":{"get":{"summary":"List quarantine (platform)","security":[{"PlatformToken":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/safety/quarantine/{quarantine_uid}/release":{"post":{"summary":"Release quarantined message for re-scan/delivery (platform)","security":[{"PlatformToken":[]}],"responses":{"200":{"description":"Released"}}}},"/v1/suppressions":{"get":{"summary":"List suppressions","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}},"post":{"summary":"Add suppression","security":[{"BearerAuth":[]}],"responses":{"201":{"description":"Created"}}}},"/v1/bounces":{"post":{"summary":"Ingest DSN/bounce (platform)","security":[{"PlatformToken":[]}],"responses":{"202":{"description":"Accepted"}}}},"/v1/complaints":{"post":{"summary":"Ingest ARF/complaint (platform)","security":[{"PlatformToken":[]}],"responses":{"202":{"description":"Accepted"}}}},"/unsubscribe":{"post":{"summary":"One-click unsubscribe (public, opaque token)","responses":{"200":{"description":"Always 200; idempotent"}}}},"/v1/pools":{"get":{"summary":"List IP pools","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/egress-ips":{"get":{"summary":"List egress IPs","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/holds":{"get":{"summary":"List route holds","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}},"post":{"summary":"Create route hold (platform)","security":[{"PlatformToken":[]}],"responses":{"201":{"description":"Created"}}}},"/v1/reputation/simulate":{"post":{"summary":"Simulate provider failure burst for guardrail drill (platform)","security":[{"PlatformToken":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/intel/catalog":{"get":{"summary":"Provider catalog","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/intel/collect":{"post":{"summary":"Collect provider/blocklist signals (platform)","security":[{"PlatformToken":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/intel/blocklist/query":{"post":{"summary":"Licensed DNSBL query — 403 if unconfigured","security":[{"PlatformToken":[]}],"responses":{"200":{"description":"OK"},"403":{"description":"Unauthorized query"}}}},"/v1/intel/signals":{"get":{"summary":"List intel signals with provenance","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/admin/login":{"post":{"summary":"Operator login with TOTP MFA","responses":{"200":{"description":"Session token"}}}},"/v1/admin/protected-actions":{"post":{"summary":"Request dual-approval protected action","security":[{"BearerAuth":[]}],"responses":{"201":{"description":"Pending"}}}},"/v1/admin/abuse-cases/{case_uid}/incident-stop":{"post":{"summary":"Incident stop — revoke keys, hold tenant, preserve evidence","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/compliance/catalog":{"get":{"summary":"Jurisdiction pack catalog + strict baseline","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/compliance/packs/legal-review":{"post":{"summary":"Attach counsel sign-off to a jurisdiction pack","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/compliance/consent":{"post":{"summary":"Record consent evidence","security":[{"BearerAuth":[]}],"responses":{"201":{"description":"Created"}}}},"/v1/compliance/rights":{"post":{"summary":"Open export/delete/correct rights request","security":[{"BearerAuth":[]}],"responses":{"201":{"description":"Created"}}}},"/v1/ops/preflight":{"get":{"summary":"Node preflight checks","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"},"503":{"description":"Failed checks"}}}},"/v1/ops/pilot-readiness":{"post":{"summary":"Run pilot readiness checklist","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/ops/internet-approval":{"post":{"summary":"Create signed Internet delivery approval (does not flip env)","security":[{"BearerAuth":[]}],"responses":{"201":{"description":"Created"}}}},"/v1/ops/capacity":{"post":{"summary":"Measure capacity model vs HA gates","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/ops/slo-burn":{"post":{"summary":"Run SLO burn (accept latency, health, unsubscribe)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/ops/ha-gates":{"post":{"summary":"Evaluate whether NATS/ClickHouse/regional HA are justified","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/status":{"get":{"summary":"Public status page JSON","responses":{"200":{"description":"OK"}}}},"/v1/launch/readiness":{"post":{"summary":"Run launch readiness checklist","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/launch/pricing":{"get":{"summary":"List pricing plans","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}},"/v1/launch/oncall":{"get":{"summary":"On-call coverage","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK"}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"},"PlatformToken":{"type":"http","scheme":"bearer","description":"Platform API_TOKEN"}}}}