What do the TalkGenAI error codes mean?

Every error is JSON with a code and a message you can show the user. This table lists every code the agent API and the MCP server return, what causes it, and what to do.

Which errors can I get?

Status	`code`	What to do
401	`unauthorized`	Key missing, malformed or revoked. Create a new one at /connect-agent
403	`insufficient_credits`	Out of credits. The response has `credit_cost` and `upgrade_url`
403	`domain_mismatch`	You used a WordPress plugin key, which is locked to one site. Create an agent key instead
403	`plan_upgrade_required`	The feature is on a higher plan. `upgrade_url` is in the response
403	`live_publish_disabled`	This workspace forbids agents publishing live. Save a draft instead
403	`scope_missing`	The key was created without that permission (`articles`, `publish` or `reddit`). The user must create a key with it
403	`agent_key_not_allowed_here`	Agent keys work only on `/api/v1/*` and `/mcp`
403	`reddit_agent_not_enabled`	The account has no Reddit agent. It starts free at /reddit-agent
400	`not_ready`	The article has not finished generating. Keep polling
404	`site_not_found`	Bad `connection_id`. Read `GET /api/v1/sites` again
404	`plan_not_found`, `card_not_found`	Read `GET /api/v1/content-plan` again
409	`card_already_published`	That content plan card is done. Pick another
402	none	Drafting a locked Reddit lead on an expired free trial. Unlock the Reddit agent in Billing
429	`rate_limited`	Slow the polling down and retry after 60 seconds

Why does image generation fail on a free account?

A free account cannot spend its monthly credits on images. Image generation has to be covered by bonus credits. If image: true returns insufficient_credits while total_available looks large enough, generate without the image, or upgrade.

How often can I call the API?

Read endpoints (get an article, list sites, check credits) are limited to about 60 requests a minute per key. This is a best-effort limit, not a hard guarantee. Poll an article every 5 to 10 seconds, not continuously. Last updated: 2026-10-05

Connect your agent

Reference

TalkGenAI API and MCP error codes

What do the TalkGenAI error codes mean?

Which errors can I get?

Why does image generation fail on a free account?

How often can I call the API?

​What do the TalkGenAI error codes mean?

​Which errors can I get?

​Why does image generation fail on a free account?

​How often can I call the API?

​Related

What do the TalkGenAI error codes mean?

Which errors can I get?

Why does image generation fail on a free account?

How often can I call the API?

Related