Troubleshooting

When a request or a run fails, Studio returns a short string error code alongside the message. The tables below list every code you can be shown, what it means, and what to do about it. Search this page for the code you were given.

Access and requests

Code	Meaning	What to do
`AUTH_REQUIRED`	The request carried no credentials.	Sign in again.
`AUTH_EXPIRED`	Your session has expired.	Sign in again to get a fresh session.
`FORBIDDEN`	Your role or plan does not permit this action.	Ask a workspace owner for a higher role, or upgrade in Billing & Limits.
`NOT_FOUND`	The workflow, run, agent, or key does not exist in this workspace.	Check you are in the right workspace in the switcher.
`VALIDATION_ERROR`	The request body failed validation.	Correct the field named in the message and try again.
`API_KEY_READ_ONLY`	The API key you used may only read, and this call writes.	Use a key with write access. Your plan is not the problem.
`CONFLICT`	Something with that name or identity already exists.	Pick a different name.
`WORKFLOW_VERSION_CONFLICT`	The workflow was saved elsewhere after you opened it, so saving now would overwrite changes you never saw.	Reload the workflow to pick up the newer version, then reapply your edit.
`RATE_LIMITED`	Too many requests in a short window.	Wait a few seconds and retry.
`SERVICE_DISABLED`	The feature is not enabled on this deployment.	Contact [email protected] if you expected it to be available.
`ACCOUNT_ERASED`	This account was erased at your request. Its workspaces, workflows, run history and uploaded files are gone and cannot be restored.	Sign in with a different address to start a new account, or write to [email protected] if you did not ask for the deletion.
`INTERNAL_ERROR`	Something failed on our side.	Retry. If it persists, send us the run id.

Plan and workspace limits

Every code in this group means the action is allowed on a higher plan or needs a billing change. Upgrade in Billing & Limits; the change takes effect immediately.

Code	Meaning	What to do
`TIER_LIMIT_WORKFLOWS`	You have reached your workflow limit.	Delete a workflow you no longer need, or upgrade.
`TIER_LIMIT_EXECUTIONS`	You have used every execution in this month's allowance.	Wait for the allowance to reset, or upgrade.
`TIER_LIMIT_CREDITS`	Your managed AI credit allowance for the month is used up.	Buy more credits, connect your own model key, or upgrade. See Billing & Limits.
`TIER_LIMIT_CUSTOM_AGENTS`	You have reached your saved-agent limit.	Delete an agent you no longer use, or upgrade.
`TIER_LIMIT_CUSTOM_MCP`	Custom MCP servers need Pro or Business.	Upgrade to use your own MCP server.
`TIER_LIMIT_CUSTOM_AGENT_TO_AGENT`	Custom A2A needs Pro or Business.	Upgrade to delegate to external A2A agents.
`TIER_LIMIT_DOCUMENT_UPLOAD`	URL and file uploads to the Knowledge Base need Pro or Business.	Paste text directly, or upgrade.
`TIER_LIMIT_CONTENT_SAFETY_BLOCK`	The Content Safety block needs Pro or Business.	Upgrade to screen text on the canvas.
`TIER_LIMIT_CONTENT_SAFETY_TOOL`	The Content Safety agent tool needs Pro or Business.	Upgrade, or remove the tool from the agent.
`TIER_LIMIT_SUB_AGENT_TOOL`	Sub-agent delegation needs Pro or Business.	Upgrade, or detach the sub-agent.
`TIER_LIMIT_AGENT_MEMORY`	Agent memory needs Pro or Business.	Upgrade, or switch memory off for that agent.
`TIER_LIMIT_TEAM_WORKSPACE`	Team workspaces need Business.	Upgrade to Business to share a workspace.
`MANAGED_AI_NOT_AVAILABLE`	Managed AI is not available on this plan.	Connect your own model key, or upgrade.
`MODEL_NOT_ALLOWED_FOR_TIER`	The chosen model is not on your plan.	Pick a model your plan includes, or upgrade.
`SEAT_REQUIRED`	The teammate you invited needs an extra builder seat.	Confirm the seat when prompted, or invite them as a viewer. See Team workspaces.
`WORKSPACE_READ_ONLY`	The workspace is read-only until its plan is renewed.	Update the payment method to restore full access.
`NO_BILLING_CUSTOMER`	The workspace has no billing account yet.	Start a plan from Settings then Billing.
`DELETION_BLOCKED_BY_TEAM`	You still own shared workspaces, so deleting your account would take them from the people in them.	Transfer ownership of the workspaces named in the message, then delete the account.

Connections and tools

Code	Meaning	What to do
`INTEGRATION_DISCONNECTED`	The provider token expired or was revoked.	Reconnect the integration from the block config panel.
`INTEGRATION_ERROR`	The provider rejected the call.	Read the provider message in the trace and correct the block config, such as a missing recipient or an unknown channel.
`MCP_UNREACHABLE`	Studio could not reach your MCP server.	Check the server is running and publicly reachable. See Custom MCP.
`MCP_INVALID_CONFIG`	The MCP server configuration is invalid.	Re-check the server URL and the auth header.
`CUSTOM_AGENT_TO_AGENT_INVALID_CONFIG`	The Custom A2A configuration is invalid.	Re-check the agent card URL. See Custom A2A.
`SSRF_BLOCKED`	The URL points at a private, loopback, or link-local address and was refused.	Use a public address that Studio can reach from the internet.
`AGENT_IN_USE`	The agent you tried to delete is used by a workflow.	Remove the Agent blocks that pin it, then delete it.
`CONFLICT`	The workflow you tried to delete has a run in progress. Deleting it would take the run with it, along with the record of what the run has already used.	Stop the run from the run view, or wait for it to finish, then delete the workflow.

Runs

Code	Meaning	What to do
`WORKFLOW_VALIDATION_FAILED`	The workflow graph is not valid, for example it contains a cycle.	Fix the edges the builder flags and run again.
`WORKFLOW_PAUSED`	The workflow is paused.	Run it once to reactivate it.
`AGENT_TIMEOUT`	A single step ran past the task timeout.	See Step timeouts below.
`AGENT_FAILED`	A step hit a problem and could not finish.	Open the block in the trace to read the underlying error.
`MODEL_OVERLOADED`	The model provider is busy.	Retry, or switch the block to another model.

Integration disconnected

When a provider token expires, the integration shows a warning badge in the builder. To reconnect:

Click the integration block on the canvas
Click Reconnect in the config panel
Complete the OAuth flow in the popup window
The integration resumes automatically for future executions

Step timeouts

A single task has 300 seconds to reach a terminal state. That is a per-step limit, not a limit on the whole run, and it is the same on every plan. A workflow of ten steps can run far longer than 300 seconds; only an individual step that stalls is cut short, and the run fails with AGENT_TIMEOUT.

There is no timeout setting in workflow settings. If a step keeps hitting the limit:

Split the work across several blocks so no single step does everything
Reduce the number of sub-tasks in Auto Agent blocks
Use a faster model for non-critical steps
Narrow the prompt so the model returns sooner

Credit limit exceeded

When your managed AI credit allowance is exhausted, the run stops with TIER_LIMIT_CREDITS. You have three options:

Buy more credits - use Buy more credits in Settings then Billing. Bought credits are added as soon as the payment clears and do not expire.
Connect your own model key - switch to your own Anthropic or OpenAI key in Settings then Model providers to continue immediately. Those runs use no credits.
Upgrade your plan - higher plans carry larger allowances, and the change takes effect immediately.

Allowances also reset at the start of each billing cycle if you would rather wait.

Model provider errors

Overloaded - MODEL_OVERLOADED means the provider is busy. Retry, or pick another model in the block config.
Rate limited - RATE_LIMITED means too many requests in a short window. Slow down and retry.
Invalid key - re-paste your key in Settings then Model providers if it was rotated.

Still stuck? Check the FAQ. Free tier users get help on Discord community. Pro and Business subscribers can email [email protected].