Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Quick reference for sending a personal access token on every request.
Authorization: Bearer <your-token>
| Endpoint group | Required ability |
|---|---|
/workspaces | workspaces |
/workspaces/{workspace}/profiles | profiles |
/workspaces/{workspace}/posts, /posts/{post} | posts |
/workspaces/{workspace}/media_contents, /media_contents/{...}, /workspaces/{workspace}/media_library/folders, /media_library/folders/{...} | media_contents |
/analytics/*, /profiles/{profile}/metrics, /profiles/{profile}/hashtags, /workspaces/{workspace}/hashtags | analytics (and posts for some) |
403. To add an ability to an existing token, create a new token with the desired ability set — abilities cannot be added retroactively to an existing token.
| Status | Body | Cause |
|---|---|---|
401 | { "message": "Unauthenticated." } | Missing, malformed, or revoked Authorization header. |
403 | { "message": "Invalid ability provided." } | Token is valid but doesn’t include the required ability. |
403 | { "message": "This action is unauthorized." } | The user behind the token has no access to the target workspace or resource. |