Skip to main content
View as Markdown

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."
}
StatusMeaning
200The request succeeded.
400The request is not valid. The body names the problem and the fix.
401The token is missing or not valid.
402Your 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.