Content

Write, approve and publish individual posts.

POST /content

Asks the content agent for one or more posts.

Field Required Notes
brand yes Brand slug or id.
platform yes Channel slug, e.g. instagram.
prompt no Anything specific you want said.
schedule no ISO time. Defaults to the brand next best slot.
count no 1 to 10.

GET /content

Filter with ?status=needs_review, ?platform=facebook, and add ?metrics=1 for performance on each item.

{
  "data": [
    {
      "id": "3f2a…",
      "platform": "instagram",
      "body": "…",
      "hashtags": ["rahimfashion", "dhakastyle"],
      "cta": "Order now",
      "angle": "product_spotlight",
      "status": "scheduled",
      "scheduled_for": "2026-10-03T19:30:00+06:00",
      "metrics": { "reach": 4210, "engagement": 186, "clicks": 54, "conversions": 3, "revenue": 17700 }
    }
  ]
}

POST /content/{id}/approve

Marks it approved so the scheduler will publish it.

POST /content/{id}/publish

Publishes now, ahead of schedule. Returns 502 if no connected account accepted it, with the reason on the content item.