Authentication
Send the key as a bearer token. Keys are per brand; a key cannot read another brand.
curl https://api.superagent.social/v1/brands \
-H "Authorization: Bearer sk_live_..."
Create a post
POST /v1/posts
{
"brand": "br_7f3c",
"text": "Fresh pastries out at 7. Gone by noon.",
"channels": ["instagram", "facebook"],
"at": "2026-11-20T09:00:00Z",
"status": "scheduled"
}
Endpoints
| Method | Path | Does |
|---|---|---|
| GET | /v1/brands | List brands on the key |
| POST | /v1/posts | Create or schedule a post |
| GET | /v1/posts/:id | Status per channel |
| POST | /v1/generate/text | Draft from a brief |
| POST | /v1/generate/image | Design at a target size |
| GET | /v1/channels/connection-url | Hosted OAuth link |
Rate limits
60 requests per minute per key. Every response carries X-RateLimit-Remaining; a 429 includes Retry-After.
Errors
{
"error": "channel_rejected",
"channel": "linkedin",
"message": "Text exceeds 3000 characters",
"request_id": "req_8f21"
}