Public API
Short answer
The decodx public API covers videos, projects, render jobs, the Brand Kit and the Library. An admin creates a service token in Settings → Advanced → Service tokens. The full reference is at https://api.decodx.ai/api-docs.
Authenticate
Send the service token in the Authorization header of each request.
curl https://api.decodx.ai/projects \
-H "Authorization: Bearer $DECODX_TOKEN"
Errors
Each error has the same body: a code, a message and, where possible, a fix.
400 Bad Request
{
"code": "validation_failed",
"message": "title: Required",
"fix": "Send a title of 1 to 120 characters."
}
| Status | Meaning |
|---|---|
| 200 | The request succeeded. |
| 400 | The request is not valid. The body names the problem and the fix. |
| 401 | The token is missing or not valid. |
| 402 | Your plan does not include this feature. The code is plan_required. |
note
Goals, Social and Visibility are in the MCP server, not in the public API. The OpenAPI file is at https://api.decodx.ai/openapi.public.json.