API

AutoCMO is API-first. The dashboard is just one client; you can drive every step from cURL, a script, or your own UI. The full OpenAPI spec lives at /openapi.json on the backend.

Quick start

Auth

Every /api/* request must include the X-API-Key header.
  curl -H 'X-API-Key: <your key>' https://api.autocmo.app/api/tier

Create a business

  POST /api/businesses
  { "name": "Acme Coffee", "description": "...", "industry": "food", "tier": "basic" }
Returns the created business; research is kicked off in the background.

Run the loop

  POST /api/businesses/{id}/research          → re-research
  POST /api/businesses/{id}/strategies        → generate strategy
  POST /api/strategies/{id}/publish           → spawn campaigns + variants
  POST /api/campaigns/{id}/optimize           → kill losers, scale winners

Read content

  GET /api/businesses/{id}/content           → all variants
  GET /api/businesses/{id}/media             → all generated images/videos
  GET /api/campaigns/{id}/variants
  GET /api/campaigns/{id}/metrics

Connect a platform (OAuth)

  POST /api/businesses/{id}/oauth/{platform}/start
  → redirect the user to authorise_url
  → on callback we store an encrypted token and the platform is live.

Health

  GET /healthz   → liveness
  GET /readyz    → liveness + DB round-trip
  GET /api/tier  → current tier + LLM model

OpenAPI

Full machine-readable spec:  https://api.autocmo.app/openapi.json
Interactive docs:           https://api.autocmo.app/docs

Need an API key? Run the service yourself (see /install) — or contact us via the GitHub repo.