List Error Codes

GET

/v2/errors

Returns the full catalog of machine-readable generation error codes — each with a human-readable message and a suggested fix. This endpoint is unauthenticated. Pair it with the errorCode field returned on a failed generation so an agent can look up what went wrong and how to correct it without hard-coding error strings.

Response

Error catalog retrieved successfully

codestring

The stable error code (e.g. generation_input_video_inaccessible).

messagestring

A human-readable description of the error.

suggestionstring

A suggested fix an agent can act on.

Errors

500

Internal Server Error

1	[
2	{
3	"code": "generation_input_video_inaccessible",
4	"message": "The video input could not be fetched.",
5	"suggestion": "Check that the video URL is publicly reachable, or upload the file via POST /v2/assets/upload and reference it by assetId."
6	},
7	{
8	"code": "generation_plan_duration_exceeded",
9	"message": "The output duration exceeds your plan limit.",
10	"suggestion": "Use shorter media or upgrade your plan."
11	}
12	]