Docs menu

Error Codes

Every error the API returns, and what to do.

Sample response

{
  "errors": [{
    "code": "001",
    "detail": "Maximum number of requests reached",
    "solution": "You have been rate-limited. Wait a minute and try again."
  }],
  "api_limits": { "requests_in_last_minute": 61, "requests_allowed_per_minute": 60 }
}

Error codes defined

HTTP status	Error code	Message	What to do
429	`001`	Maximum number of requests reached	You have been rate-limited. Wait a minute and try again.
400	`002`	Invalid brand_id provided	Send the Brand ID shown under API & SDK in the app.
400	`003`	You have reached your post generation limit	Wait for the 24-hour limit to reset, or raise API_DAILY_POST_LIMIT.
400	`004`	You already have 10 posts inProgress	Wait until the posts in progress are completed, then try again.
400	`005`	Your request method is invalid	Use the method shown for this endpoint.
400	`006`	Your provided text is too small	Send at least 3 words and 20 characters.
400	`007`	The provided value for the media_type field is not valid	Use single_image, carousel or video.
400	`008`	The provided value for the input_language or output_language field is not valid	Use one of the languages listed in the docs.
400	`009`	The provided value for the video_duration field is not valid	Use short or long.
400	`010`	The provided value for the post_type field is not valid	Use generic, meme or quotes.
400	`011`	The provided value for the post_type field is not valid for the given media_type	Memes and quotes are single_image posts.
400	`012`	A template_id was not found	Use an id from get_templates.
400	`013`	A media_url could not be used	Send public https links straight to JPG, PNG or WebP images, 15 MB or less.
400	`014`	Page number or items number is invalid	Send whole numbers greater than 0.
400	`015`	Provided aspect_ratio is not supported	Use square, portrait, landscape or all.
401	`016`	Invalid API key. Please provide a valid API key.	Send your key in the Authorization header.

« Get Templates

Examples »

Docs menu

Error Codes

Every error the API returns, and what to do.

Sample response

{
  "errors": [{
    "code": "001",
    "detail": "Maximum number of requests reached",
    "solution": "You have been rate-limited. Wait a minute and try again."
  }],
  "api_limits": { "requests_in_last_minute": 61, "requests_allowed_per_minute": 60 }
}

Error codes defined

HTTP status	Error code	Message	What to do
429	`001`	Maximum number of requests reached	You have been rate-limited. Wait a minute and try again.
400	`002`	Invalid brand_id provided	Send the Brand ID shown under API & SDK in the app.
400	`003`	You have reached your post generation limit	Wait for the 24-hour limit to reset, or raise API_DAILY_POST_LIMIT.
400	`004`	You already have 10 posts inProgress	Wait until the posts in progress are completed, then try again.
400	`005`	Your request method is invalid	Use the method shown for this endpoint.
400	`006`	Your provided text is too small	Send at least 3 words and 20 characters.
400	`007`	The provided value for the media_type field is not valid	Use single_image, carousel or video.
400	`008`	The provided value for the input_language or output_language field is not valid	Use one of the languages listed in the docs.
400	`009`	The provided value for the video_duration field is not valid	Use short or long.
400	`010`	The provided value for the post_type field is not valid	Use generic, meme or quotes.
400	`011`	The provided value for the post_type field is not valid for the given media_type	Memes and quotes are single_image posts.
400	`012`	A template_id was not found	Use an id from get_templates.
400	`013`	A media_url could not be used	Send public https links straight to JPG, PNG or WebP images, 15 MB or less.
400	`014`	Page number or items number is invalid	Send whole numbers greater than 0.
400	`015`	Provided aspect_ratio is not supported	Use square, portrait, landscape or all.
401	`016`	Invalid API key. Please provide a valid API key.	Send your key in the Authorization header.

« Get Templates

Examples »