Skip to main content

Error Code Reference

Every error response returned by the Turing Platform includes a business error code (a 4-digit integer). The HTTP status code provides only a coarse-grained classification; the error code combined with the message field is the authoritative source for diagnosing issues.

Error Response Structure​

All business errors (non-2xx) follow a unified structure:

{
"code": 1124,
"message": "HTTP request timeout",
"data": {},
"trace_id": "tur_xxxxxxxx"
}
FieldDescription
code4-digit business error code (see the index below)
messageEnglish error description
dataAdditional context (varies by error type)
trace_idRequest trace ID for the corresponding request — see Request Tracing

Error Code Index​

The table below is automatically derived from the backend TuringErrorCode enum (see scripts/gen_error_codes.py) and is updated whenever a new error code is added to the backend.

Deep Links

Each error row has an anchor — for example, /api-guides/reliability/error-codes#1124 jumps directly to that entry. You can share an anchor link with your team when you encounter an error code.

Showing 375 / 375
codeHTTPCategoryname / description
0200Success
SUCCESS
Success
1000500Other
UNKNOWN_ERROR
An error occurred
1001400Other
NOT_IMPLEMENTED
Not implemented
1002400Other
NOT_SUPPORTED
Not supported
1003404Other
NOT_FOUND
Not found
1004422Other
VALIDATION_ERROR
Validation error
1005401Other
AUTHENTICATION_ERROR
Authentication error
1006500Other
CONFIGURATION_ERROR
Configuration error
1050400Other
INVALID_ARGUMENT
Invalid argument
1051400Other
INVALID_ID
Invalid ID
1100403Rate limit & budget
TOKEN_VERIFICATION_FAILED
Token verification failed
1101400Rate limit & budget
SYSTEM_PROMPT_TOKENS_EXCEED
System prompt tokens exceed
1102400Rate limit & budget
USER_LEFT_TOKENS_EXCEED
You exceeded your current quota
1103400Rate limit & budget
SSE_STREAMING_ERROR
SSE streaming error
1104429Rate limit & budget
RATE_LIMIT_EXCEEDED
Rate limit exceeded
1105400Rate limit & budget
HTTP_REQUEST_ERROR
HTTP request error
1106400Rate limit & budget
HTTP_STREAMING_ERROR
HTTP streaming error
1107400Rate limit & budget
WEBSOCKET_SEND_ERROR
Websocket send error
1108500Rate limit & budget
REDIS_DATABASE_URI_NOT_SET
Redis database URI not set
1109500Rate limit & budget
POSTGRES_DATABASE_ENDPOINT_NOT_SET
Postgres database endpoint not set
1110429Rate limit & budget
USER_EXPENSE_OVER_BUDGET
User expense not enough
1111429Rate limit & budget
USER_RPM_LIMIT_EXCEEDED
User RPM limit exceed
1112429Rate limit & budget
USER_TPM_LIMIT_EXCEEDED
User TPM limit exceed
1113429Rate limit & budget
CLIENT_TPM_LIMIT_EXCEEDED
Client TPM limit exceed
1114429Rate limit & budget
CLIENT_RPM_LIMIT_EXCEEDED
Client RPM limit exceed
1115429Rate limit & budget
SERVICE_RATE_LIMIT_EXCEEDED
Service rate limit exceed
1116404Rate limit & budget
USER_USAGE_LIMIT_NOT_FOUND
User usage limit not found
1117400Rate limit & budget
RESOURCE_USAGE_MANAGER_NOT_SET
Resource usage manager not set
1118400Rate limit & budget
RESOURCE_USAGE_CHECK_FAILED
Resource usage check failed
1119400Rate limit & budget
SENSITIVE_WORD_DETECTED_INPUT
Sensitive words are detected in input
1120400Rate limit & budget
SENSITIVE_WORD_DETECTED_OUTPUT
Sensitive words are detected in output
1121400Rate limit & budget
EXCEEDS_MAX_LENGTH_LIMIT
Exceeds max length limit
1122429Rate limit & budget
PROVIDER_RATE_LIMIT_EXCEEDED
Rate limit exceeded from provider side
1123500Rate limit & budget
PRICING_CALCULATION_ERROR
Pricing calculation error
1124408Rate limit & budget
HTTP_TIMEOUT_ERROR
HTTP request timeout
1125503Rate limit & budget
WORKLOAD_SATURATED
Service overloaded, workload budget saturated
1126429Rate limit & budget
RELAY_WEEKLY_QUOTA_EXCEEDED
Relay weekly quota exhausted
1127429Rate limit & budget
PORTAL_APPLICATION_OVER_BUDGET
Portal application monthly quota exhausted
1200400File
FILE_IS_NULL_ERROR
File not found
1201400File
FILE_DUPLICATE_ERROR
File already exists
1202400File
FILE_TOO_LARGE_ERROR
File too large
1203400File
UPLOAD_FILE_FAILED_ERROR
Upload file Failed
1204400File
FILE_DECODE_ERROR
File decode error
1205400File
FILE_NOT_EXIST_ERROR
File not exist error
1206400File
FILE_FORMAT_NOT_SUPPORTED
File format not supported
1207400File
FILE_UPLOAD_VALIDATION_ERROR
File upload validation error
1208400File
FILE_RETRIEVER_UNSUPPORTED_DOCUMENT_ERROR
File retriever unsupported document
1209400File
FILE_INGESTION_ERROR
File ingestion error
1210400File
FILE_CONTENT_GET_FAILED_ERROR
File content get failed
1211400File
FILE_CONVERSION_ERROR
Conversion error
1212429File
FILE_INGESTION_QUEUE_FULL
File ingestion queue full
1240400Assistant
ASSISTANT_UNIQUE_NAME_EXIST
Assistant unique_name exist
1241400Assistant
ASSISTANT_UNIQUE_NAME_SET_ONCE
Assistant unique_name can only be set once
1242404Assistant
ASSISTANT_REVISION_ALIAS_NOT_FOUND
Assistant revision alias not found
1243400Assistant
ASSISTANT_IMAGE_EDIT_NOT_SUPPORTED
Assistant image edit not supported
1250404Assistant
ASSISTANT_ENGINE_NOT_FOUND
Assistant engine not found
1251404Assistant
ASSISTANT_ENGINE_NOT_SUPPORTED
Assistant engine not supported
1252400Assistant
ASSISTANT_INSTRUCTIONS_TOKEN_COUNT_EXCEED
Assistant instructions token count exceed
1253400Assistant
ASSISTANT_TOOL_COUNT_EXCEED
Assistant tool exceed
1254400Assistant
ASSISTANT_RETRIEVER_NOT_SUPPORTED
Assistant retriever not supported
1255400Assistant
ASSISTANT_CODE_INTERPRETER_NOT_SUPPORTED
Assistant code interpreter not supported
1256400Assistant
ASSISTANT_GPT_VISION_NOT_SUPPORTED
Assistant gpt vision not supported
1257400Assistant
ASSISTANT_FUNCTION_DESCRIPTION_TOO_LONG
Assistant function description too long
1258400Assistant
ASSISTANT_TOOL_NOT_SUPPORTED
Assistant tool not supported
1259400Assistant
ASSISTANT_ENGINE_NOT_INPUT
Assistant engine not input
1260400Assistant
ASSISTANT_THREAD_NOT_EXIST
Assistant thread not exist
1261400Assistant
ASSISTANT_NOT_EXIST
Assistant not exist
1262400Assistant
ASSISTANT_REVISION_NOT_EXIST
Assistant revision not exist
1263400Assistant
INVALID_TOOL_TYPE
Invalid tool type
1264400Assistant
ASSISTANT_MESSAGE_EMPTY_CONTENT
Assistant message empty content
1265400Assistant
ASSISTANT_GPT_VISION_TOOL_INVALID_REQUEST
Assistant gpt vision tool invalid request
1266400Assistant
ASSISTANT_MESSAGE_REQUEST_ERROR
Assistant message request error
1267400Assistant
ASSISTANT_DALL_E_NOT_SUPPORTED
Assistant dall-e not supported
1268400Assistant
ASSISTANT_DALL_E_3_NOT_SUPPORTED
Assistant dall-e-3 not supported
1269400Assistant
ASSISTANT_WEB_SEARCH_NOT_SUPPORTED
Assistant web search not supported
1270400Assistant
ASSISTANT_WEB_SEARCH_BING_NOT_SUPPORTED
Assistant bing search not supported
1271400Assistant
ASSISTANT_WEB_SEARCH_GOOGLE_NOT_SUPPORTED
Assistant google search not supported
1272400Assistant
ASSISTANT_MESSAGE_QA_PAIR_NOT_EXIST
Assistant message pair for question and answer does not exist
1273400Assistant
ASSISTANT_FORBIDDEN_CONTENT
Content has been forbidden
1274400Assistant
ASSISTANT_INVALID_ID
Invalid ID
1275403Assistant
ASSISTANT_NOT_AUTHORIZED
Assistant not authorized
1276400Assistant
ASSISTANT_INCONSISTENT
Assistant's inconsistent with thread
1277400Assistant
ASSISTANT_THREAD_MAX_FAVORITE_NUM
Max favorite threads number reaches
1278400Assistant
ASSISTANT_REVISION_FORK_DRAFT_ERROR
Can not Fork draft revision
1279400Assistant
ASSISTANT_IMAGE_GENERATION_NOT_SUPPORTED
Assistant image generation not supported
1280400Assistant
ASSISTANT_INCONSISTENT_CLIENT_ENV
Assistant's inconsistent with client/environment
1281400Assistant
ASSISTANT_AGENT_TOOL_NAME_EMPTY
Assistant agent tool name is empty
1282400Assistant
ASSISTANT_AGENT_TOOL_NOT_SUPPORTED
Assistant agent tool not supported
1283400Assistant
ASSISTANT_AGENT_TOOL_AIUI_NOT_SUPPORTED
Assistant AIUI not supported
1284400Assistant
ASSISTANT_WORKFLOW_TOOL_NOT_SUPPORTED
Assistant Workflow tool not supported
1285400Assistant
ASSISTANT_CODE_INTERPRETER_API_ERROR
Assistant code interpreter API error
1286400Assistant
ASSISTANT_CANVAS_TOOL_NOT_SUPPORTED
Assistant Canvas tool not supported
1287400Assistant
ASSISTANT_MULTIPLE_CANVAS_ID_NOT_SUPPORTED
Assistant Multiple canvas ids not supported
1288400Assistant
ASSISTANT_NOT_SHARED
Assistant not shared
1289400Assistant
ASSISTANT_DOCUMENT_RETRIEVER_TOOL_NOT_SUPPORTED
Assistant document retriever tool not supported
1290400Assistant
ASSISTANT_DOCUMENT_TOO_LARGE
Document is too large
1291400Assistant
ASSISTANT_DOCUMENT_TOO_SHORT
Document is too short
1292400Assistant
ASSISTANT_DOCUMENT_DECODE_ERROR
Document decode error
1293400Assistant
ASSISTANT_DOCUMENT_NOT_FOUND
Document not found
1294400Assistant
ASSISTANT_DOCUMENT_PROCESSING_ERROR
Document processing error
1295400Assistant
ASSISTANT_DOCUMENT_NO_VALID_CHAPTERS
Document has no valid chapters
1296400Assistant
ASSISTANT_DOCUMENT_INVALID_CONTENT
Document has invalid content
1297400Assistant
ASSISTANT_DOCUMENT_DOWNLOAD_FAILED
Document download failed
1298400Assistant
ASSISTANT_MCP_TOOL_NOT_SUPPORTED
Assistant MCP tool not supported
1299400Assistant
ASSISTANT_TOOL_EXECUTION_ERROR
Tool execution error
1300404Workflow
USER_NOT_FOUND
User not found
1301403Workflow
USER_NOT_ACTIVE
User not active
1302400Workflow
CLIENT_NAME_IS_EMPTY
Client name is null
1303401Workflow
API_KEY_IS_EMPTY
API key is null
1304401Workflow
API_KEY_NOT_EXIST
API key not exist
1305403Workflow
API_KEY_NOT_MATCH_CLIENT
API key not match client
1306403Workflow
API_KEY_NOT_MATCH_ENVIRONMENT
API key not match environment
1307409Workflow
USER_REPEAT
User with same email/username exists
1308403Workflow
NOT_AUTHORIZED
Insufficient permissions
1309401Workflow
NOT_AUTHENTICATED
Invalid authentication state
1310401Workflow
AUTHENTICATION_EXPIRED
Authentication has been expired
1311404Workflow
ROLE_NOT_FOUND
Role not found
1312409Workflow
ROLE_REPEAT
Role with same name exists
1313400Workflow
INVALID_ROLE_CLIENT
Role client is invalid
1314400Workflow
CLIENT_ENV_INVALID
Client or environment is not valid
1315400Workflow
USER_MESSAGE_EMPTY_CONTENT
Input message is empty
1316404Workflow
TENANT_NOT_FOUND
Tenant not found
1317400Workflow
TENANT_INCONSISTENT
Tenant inconsistent with client/environment
1318401Workflow
API_KEY_INVALID
API key is invalid
1319401Workflow
UNKNOWN_CLIENT
Unknown client
1320401Workflow
INVALID_SSO_TOKEN
Invalid sso token
1321401Workflow
MISSING_TURING_AND_SSO_TOKEN
Missing turing and sso token
1322401Workflow
NOT_SUPPORTED_AUTH_SCHEME
Not supported auth scheme
1323401Workflow
TCL_SIGNATURE_ERROR
TCL signature error
1324429Workflow
TOO_MANY_API_KEYS
Too many API keys
1326400Workflow
API_KEY_NAME_DUPLICATE
API key name duplicate
1327400Workflow
USER_USAGE_TIER_INVALID
Invalid usage tier
1328404Workflow
CLIENT_NOT_FOUND
Client not found
1329409Workflow
CLIENT_NAME_DUPLICATE
Client with same name already exists
1330409Workflow
CLIENT_ADMIN_DUPLICATE
User is already a client admin
1331409Workflow
CLIENT_ADMIN_LAST_MEMBER
Cannot remove the last client admin
1332404Workflow
CLIENT_ADMIN_NOT_FOUND
Client admin not found
1333403Workflow
CLIENT_NOT_EDITABLE
This client is managed by its own subsystem and cannot be modified through this endpoint
1334400Workflow
API_KEY_OWNER_REQUIRED
API key owner username is required for this client
1335400Workflow
API_KEY_OWNER_NOT_SUPPORTED
This client does not support naming an API key owner
1336400Workflow
IDM_AGENT_TOKEN_INVALID
Invalid IDM agent token
1337400Workflow
OU_RATE_LIMIT_EXCEEDS_CEILING
OU rate limit exceeds the platform ceiling
1338503Workflow
OU_ROSTER_NOT_LOADED
OU administrator roster not loaded
1339409Workflow
OU_POLICY_CONFLICT
OU policy conflicts with an existing one
1340400Workflow
OU_MEMBER_LISTING_TOO_LARGE
OU has too many members to list
1341403Workflow
OU_POLICY_SERVICE_DISABLED
Access to this service is disabled by OU policy
1342403Workflow
TOKEN_SCOPE_NOT_PERMITTED
This credential is not scoped for the requested resource
1343403Workflow
IDM_AGENT_USER_NOT_REGISTERED
This employee has no Turing account yet. Ask them to sign in to the Turing portal once, after which an agent can act on their behalf.
1344409Workflow
ORG_TREE_VERSION_CONFLICT
The default org tree was published by someone else, reload and retry
1345409Workflow
CLIENT_ROOT_USER_NOT_CONFIGURED
This client has no root user yet, so it cannot issue API keys; ask the platform team to set one up
1400404Content safety
DATABASE_RESOURCE_NOT_FOUND
Database resource not found
1401400Content safety
DATABASE_RESOURCE_CREATE_FAILED
Database resource create failed
1402400Content safety
DATABASE_RESOURCE_UPDATE_FAILED
Database resource update failed
1403400Content safety
DATABASE_RESOURCE_DELETE_FAILED
Database resource delete failed
1404400Content safety
DATABASE_RESOURCE_DUPLICATE
Database resource duplicate
1405404Content safety
OPEN_SEARCH_NO_RESULT
No result found
1405500Content safety
PG_DATABASE_TRANSACTION_FAILED
PG Database transaction failed
1406503Content safety
USAGE_WAREHOUSE_UNAVAILABLE
Usage warehouse temporarily unavailable
1500404Auth
TOPIC_NOT_FOUND
Topic not found
1501404Auth
INDEX_NOT_FOUND
Index not found
1600404Billing
ASSISTANT_TAG_NOT_FOUND
Assistant tag not found
1601409Billing
ASSISTANT_TAG_REPEAT
Assistant tag with same name exists
1700404Other
WORKFLOW_NOT_FOUND
Workflow not found
1701404Other
WORKFLOW_REVISION_NOT_FOUND
Workflow revision not found
1702400Other
WORKFLOW_INVALID
Workflow invalid
1703400Other
WORKFLOW_FORK_DRAFT_ERROR
Can not Fork draft workflow revision
1704400Other
WORKFLOW_SAVE_DRAFT_ERROR
Only draft revision can be saved to normal
1705400Other
WORKFLOW_PUBLISH_ERROR
Only normal revision can be published
1706400Other
WORKFLOW_RUN_ERROR
Workflow run error
1707400Other
WORKFLOW_CODE_NODE_ERROR
Workflow code node error
1708400Other
WORKFLOW_THREAD_NOT_EXIST
Workflow thread not exist
1720404Other
MEMORY_STORE_NOT_FOUND
Memory store not found
1721400Other
MEMORY_CUSTOM_INSTRUCTIONS_TOO_LONG
Custom instructions exceed maximum token limit
1722400Other
MEMORY_SUMMARY_NOT_ENABLED
User summary feature is not enabled
1723429Other
MEMORY_SUMMARY_RATE_LIMITED
Manual regeneration is limited to once every 3 days
1724404Other
MEMORY_NOTE_NOT_FOUND
Memory note not found
1730409Other
USER_TIER_APPLICATION_PENDING_EXISTS
A pending tier application already exists, please cancel it first
1731404Other
USER_TIER_APPLICATION_NOT_FOUND
Tier application not found
1732400Other
USER_TIER_APPLICATION_NOT_CANCELABLE
Only pending applications can be canceled
1733409Other
USER_TIER_APPLICATION_NOT_REVIEWABLE
Only pending applications can be reviewed
1734409Other
PORTAL_OU_DEFAULT_TIER_IN_PROGRESS
Another default-tier update for this OU is already in progress, please retry
1740409Other
LTM_EVENT_EXPIRED
LTM Event is past the Space retention period
1745409Other
LTM_ACTOR_ERASURE_IN_PROGRESS
This actor's LTM data is being erased; retry later
1746409Other
LTM_MEMORY_ALREADY_EXISTS
An LTM memory record already holds this Profile field; update it instead
1747400Other
LTM_MEMORY_NOT_WRITABLE
Only Facts and Profile memory records can be written through the record API
1748400Other
LTM_MEMORY_RECORD_INVALID
LTM memory record input is invalid for this Space
1749400Other
LTM_METADATA_KEY_INVALID
Metadata key is not declared on this LTM Space, or a declared key would be removed
1750409Other
LTM_SPACE_ALREADY_EXISTS
LTM Space already exists
1751404Other
LTM_SPACE_NOT_FOUND
LTM Space not found
1752400Other
LTM_EMBEDDING_MODEL_UNKNOWN
Unknown embedding model
1753400Other
LTM_NAMESPACE_REQUIRED
client / environment headers required for LTM namespace
1754400Other
LTM_STRATEGY_DUPLICATE
Duplicate strategy_id in Space memory strategies
1755400Other
LTM_SPACE_NAME_INVALID
name must match `[a-z0-9][a-z0-9-]{1,62}[a-z0-9]` (3-64 chars, lowercase, no edge hyphens)
1756400Other
LTM_PLATFORM_STRATEGY_UNKNOWN
Memory strategy uses an unknown platform id or the wrong memory type
1757400Other
LTM_STRATEGY_RESERVED_NAMESPACE
custom strategy_id starts with `_` which is reserved for platform built-ins
1758400Other
LTM_PORTAL_OWNER_REQUIRED
portal client requires authenticated user; user_id_with_prefix missing from request context
1759400Other
LTM_LLM_FAMILY_UNKNOWN
llm_family is not in the platform's supported brand list
1760404Other
LTM_MEMORY_NOT_FOUND
LTM memory record not found
1761400Other
LTM_MEMORY_EMBEDDING_DIM_MISMATCH
embedding vector length does not match the Space's embedding_model dimension
1762400Other
LTM_MEMORY_LIST_CURSOR_INVALID
opaque pagination cursor could not be decoded
1763422Other
LTM_SUMMARY_NO_EVENTS
no Events found for the requested (space, actor, session); nothing to summarize
1764502Other
LTM_SUMMARY_LLM_EMPTY
LLM returned empty summary text
1765500Other
LTM_CONSOLIDATION_HANDLER_MISSING
no consolidation handler registered for this memory_type
1766502Other
LTM_SUMMARY_OUTPUT_REJECTED
LLM summary output failed structural validation (refusal / runaway length)
1767400Other
LTM_STRATEGY_NOT_ENABLED
strategy_id is not enabled or declared for this Space
1768400Other
LTM_STRATEGY_TYPE_MISMATCH
strategy's target_type does not match the memory_type being written
1769400Other
LTM_SEARCH_ACTOR_SCOPE_REQUIRED
search requires actor_id or include_shared=true to declare the actor partition
1770400Other
LTM_SEARCH_ACTOR_IDS_EMPTY
actor_ids cannot be an empty list; pass null for all actors in tenant scope
1771503Other
LTM_MEMORY_SEARCH_EMBEDDING_FAILED
search query embedding generation failed
1772503Other
LTM_MEMORY_WRITE_EMBEDDING_FAILED
write content embedding generation failed
1773400Other
LTM_SEARCH_MEMORY_TYPE_UNSUPPORTED
Search supports only Facts and Summary memory types
1774409Other
LTM_DETERMINISTIC_ID_CUTOVER_CONFLICT
Legacy and v1 records are both active for one deterministic identity
1775409Other
LTM_PROFILE_SCHEMA_FROZEN
profile_schema is frozen after the first ActorOwner Event
1776400Other
LTM_SPACE_PRINCIPAL_NOT_CONFIGURED
No model credential could be resolved for this Space principal
1777400Other
LTM_MEMORY_DEFINITION_INVALID
Memory profile/topic definitions require a non-empty description for every key
1778400Other
LTM_SPACE_LIST_CURSOR_INVALID
Invalid LTM Space list cursor
1779403Other
LTM_CLIENT_MEMBERSHIP_REQUIRED
caller holds no role on this client; client-scoped LTM namespaces are not readable
1780404Other
LTM_EVENT_NOT_FOUND
LTM Event not found
1781400Other
LTM_EVENT_LIST_CURSOR_INVALID
Invalid LTM Event list cursor
1782409Other
LTM_EVENT_IDEMPOTENT_DUPLICATE
Duplicate idempotent LTM Event write
1783400Other
LTM_EVENT_PURGE_REQUIRES_ACTOR
GDPR purge requires a concrete actor_id
1784409Other
LTM_REVISION_CONFLICT
Document revision conflict — re-read and retry
1785409Other
LTM_SUMMARY_VERSION_CONFLICT_EXHAUSTED
Summary pipeline exhausted optimistic-concurrency retries; events routed to DLQ
1786400Other
LTM_CONTEXT_ACTOR_SCOPE_REQUIRED
Context request requires actor_id or include_shared=true
1787400Other
LTM_CONTEXT_INVALID_SECTIONS
Context sections filter contains an unknown section name
1788502Other
LTM_CONTEXT_VIEW_READ_FAILED
Context storage read failed; no partial context is served
1789502Other
LTM_MEMORY_SEARCH_READ_FAILED
Memory search storage read failed
1790400Other
LTM_REFLECTION_PRESET_UNKNOWN
Reflection preset is not declared/enabled for this Space
1791400Other
LTM_REFLECTION_SCOPE_REQUIRED
Reflection request requires actor_id
1792502Other
LTM_REFLECTION_GENERATE_FAILED
Reflection synthesis failed; no record was written
1793409Other
LTM_REFLECTION_VERSION_CONFLICT_EXHAUSTED
Reflection synthesis exhausted optimistic-concurrency retries
1794400Other
LTM_SYNTHESIS_PRESET_INVALID
Invalid custom synthesis preset declaration
1795502Other
LTM_EXTRACTION_OUTPUT_INVALID
LTM extraction produced malformed output that could not be parsed into candidates
1796400Other
LTM_MEMORY_QUERY_EMBEDDING_REQUIRED
Memory candidate search requires a query embedding for the requested mode
1797400Other
LTM_MODEL_PROFILE_INVALID
Invalid model_profile: missing default model, unknown stage key, or retired stored configuration
1798409Other
LTM_IDEMPOTENCY_KEY_CONFLICT
Idempotency key was already used with a different source payload
1799409Other
LTM_MANAGED_MEMORY_TURN_CONFLICT
Managed Memory turn was reused with a different recall binding
1800404Other
CANVAS_NOT_FOUND
Canvas not found
1801400Other
CANVAS_LOAD_ERROR
Canvas load error
1802404Other
CANVAS_REVISION_NOT_FOUND
Canvas revision not found
1803400Other
CANVAS_TARGET_NOT_FOUND
Canvas update target not found
1804400Other
CANVAS_TARGET_AMBIGUOUS
Canvas update target is ambiguous
1900503Other
PROMPT_SEARCH_FAILED
Prompt search failed
1901400Other
PROMPT_NAME_DUPLICATE
Prompt name already exists
1902404Other
PROMPT_NOT_FOUND
Prompt not found
1903503Other
PROMPT_REVISION_SAVE_FAILED
Prompt revision save failed
1904400Other
PROMPT_REVISION_VALIDATION_FAILED
Prompt revision validation failed
1905404Other
PROMPT_REVISION_NOT_FOUND
Prompt revision not found
1906403Other
PROMPT_PROTECTED_LABEL_NOT_ALLOWED
Prompt protected label not allowed
1907400Other
PROMPT_REVISION_DELETE_HAS_LABELS
Prompt revision delete has labels
1908503Other
PROMPT_SAVE_FAILED
Prompt save failed
1909400Other
PROMPT_REVISION_LABEL_CONFLICT
Prompt revision label conflict
2001400General
IMAGE_GENERATION_FAILED
Image generation failed
2002400General
IMAGE_GENERATION_MODEL_NOT_SUPPORTED
Image generation model not supported
2003404General
IMAGE_GENERATION_MODEL_NOT_FOUND
Image generation model not found
2004400General
IMAGE_GENERATION_ADD_METADATA_FAILED
Add image metadata failed
2005400General
IMAGE_GENERATION_BLOCKED
Image generation blocked
2006400General
IMAGE_GENERATION_ADD_WATERMARK_FAILED
Add image watermark failed
2007404General
IMAGE_EDIT_MODEL_NOT_FOUND
Image edit model not found
2008500General
IMAGE_EDIT_ERROR
Image edit error
2009404General
IMAGE_SCALING_MODEL_NOT_FOUND
Image scaling model not found
2010500General
IMAGE_SCALING_ERROR
Image scaling error
2011500General
IMAGE_PRICING_ERROR
Image pricing error
2100404General
TASK_NOT_FOUND
Task not found
2101403General
TASK_OPERATION_INVALID
Task operation invalid
2102400General
TASK_MAX_AMOUNT_REACHED
Task max request reached
2103404General
TASK_RUN_NOT_FOUND
Task run not found
2104403General
TASK_RUN_OPERATION_INVALID
Task run operation invalid
2105400General
TASK_DEFINITION_INVALID
Task definition invalid
2106400General
TASK_RUN_OPERATION_FAILED
Task run operation failed
2200400General
SPEECH_GENERATION_FAILED
Speech generation failed
2300400General
EMBEDDING_GENERATION_FAILED
Embedding generation failed
2400503General
TRANSLATION_ERROR
Translation error
2500503General
TRANSCRIPTION_ERROR
Transcription error
2501400General
TRANSCRIPTION_PHRASE_ERROR
Transcription phrase error
2600400General
ACCESS_INTERNAL_DATA_FAILED
Access TCL internal data failed
2601403General
NOT_ALLOWED
Not allowed
2700400General
MCP_SERVER_ERROR
MCP server error
2800400General
VIDEO_GENERATION_CREATED_FAILED
Video generation created failed
2801404General
VIDEO_DOWNLOAD_FAILED
Video download failed
2802404General
VIDEO_NOT_FOUND
Video not found
2803400General
VIDEO_STATUS_CHECK_FAILED
Video status check failed
2804400General
VIDEO_DELETE_FAILED
Video delete failed
2805429General
VIDEO_SERVER_BUSY
Video Generation Server Busy
2806429General
VIDEO_WEEKLY_LIMIT_EXCEEDED
Weekly video generation limit reached
2850403General
EMPLOYEE_NOT_ACTIVE
您的身份未通过 TCL 统一身份认证,API 访问已被限制。如需协助,请访问帮助页面 https://live-turing-docs.cn.llm.tcljd.com/support
2900400General
RERANK_FAILED
Rerank failed
3010400Other
MINIMAX_API_ERROR
Minimax API error
3011400Other
MINIMAX_RESPONSE_PARSE_ERROR
Minimax response parse error
3020400Other
XFYUN_AIUI_API_ERROR
XFYUN AIUI API error
3021400Other
XFYUN_AIUI_RESPONSE_PARSE_ERROR
XFYUN AIUI response parse error
3022400Other
XFYUN_AIUI_ANSWER_PARSE_ERROR
XFYUN AIUI answer parse error
3030400Other
AZURE_OPENAI_API_ERROR
Azure OpenAI API error
3031400Other
AZURE_OPENAI_RESPONSE_PARSE_ERROR
Azure OpenAI response parse error
3040400Other
XFYUN_SPARK_API_ERROR
XFYUN Spark API error
3041400Other
XFYUN_SPARK_RESPONSE_PARSE_ERROR
XFYUN Spark response parse error
3050400Other
OPENAI_API_ERROR
OpenAI API error
3051400Other
OPENAI_RESPONSE_PARSE_ERROR
OpenAI response parse error
3052400Other
OPENAI_CONTENT_FILTER
content_filter
3060400Other
SKYLARK_API_ERROR
Skylark API error
3061400Other
SKYLARK_RESPONSE_PARSE_ERROR
Skylark response parse error
3062400Other
EAGLELAB_RESPONSE_PARSE_ERROR
EagleLab response parse error
3070400Other
ZHIPU_API_ERROR
Zhipu API error
3071400Other
ZHIPU_RESPONSE_PARSE_ERROR
Zhipu response parse error
3080400Other
QWEN_API_ERROR
Ali Tongyi Qianwen API error
3081400Other
QWEN_RESPONSE_PARSE_ERROR
Ali Tongyi Qianwen response parse error
3090400Other
WEB_SEARCH_ERROR
Web search error
3091429Other
TOO_MANY_WEB_SEARCH_REQUESTS
Too many web search requests
3100400Other
SORA_API_ERROR
Sora API error
3101400Other
SORA_RESPONSE_PARSE_ERROR
Sora response parse error
3110400Other
ANTHROPIC_API_ERROR
Anthropic API error
3111400Other
ANTHROPIC_RESPONSE_PARSE_ERROR
Anthropic response parse error
4000400Other
PORTAL_ASSISTANT_FILE_LIMIT_REACHED
Assistant file limit reached
4001500Other
PORTAL_MEETING_OUTLINE_BAD_JSON_ERROR
Meeting outline bad json error
4002500Other
PORTAL_MEETING_OUTLINE_STORE_FAILED
Meeting outline store failed
4050400Other
USER_EMAIL_NOT_AVAILABLE
User email not available
4051409Other
TIER_APPLICATION_DUPLICATE
Duplicate tier application
4052400Other
FEISHU_APPROVAL_CREATE_FAILED
Feishu approval creation failed
4053400Other
FEISHU_APPROVAL_GET_FAILED
Feishu approval get failed
4054400Other
FEISHU_APPROVAL_CANCEL_FAILED
Feishu approval cancel failed
4055404Other
FEISHU_APPROVAL_INSTANCE_NOT_FOUND
Feishu approval instance not found
4056404Other
FEISHU_USER_NOT_FOUND
Feishu user not found
4057503Other
FEISHU_SERVICE_UNAVAILABLE
Feishu service temporarily unavailable
4100404Other
MEETING_SUMMARY_NOT_FOUND
Meeting summary not found
4101404Other
PORTAL_TRANSCRIPTION_NOT_FOUND
Transcription not found
4102503Other
MEETING_SUMMARY_MCP_CONNECTION_ERROR
MCP connection error
4103400Other
PORTAL_MEETING_SUMMARY_INVALID_INTERVIEW_PARAMS
Invalid interview parameters
4104400Other
PORTAL_MEETING_SUMMARY_INVALID_TRAINING_PARAMS
Invalid training parameters
4105403Other
MEETING_SUMMARY_PERMISSION_DENIED
Permission denied to access meeting summary
4106403Other
TRANSCRIPTION_PERMISSION_DENIED
Permission denied to access transcription
4107400Other
MEETING_SUMMARY_ATTACHMENT_FORMAT_NOT_SUPPORTED
Meeting summary attachment format not supported
4108—Other
MEETING_SUMMARY_FEATURE_RETIRED
Meeting summary feature has been retired
5000400Other
TCT_INVALID_LANGUAGE_CODE
Invalid language code
5001400Other
TCT_INVALID_TRANSCRIPTION_ID
Invalid transcription id
5002400Other
TCT_MISSING_PARAMETER
Missing Parameter
5003400Other
TCT_CONFLICTING_PARAMETERS
Conflicting Parameter
5004400Other
TCT_EMPTY_TRANSCRIPTION
Empty Transcription
5005400Other
TCT_SHORT_ORIGIN_TEXT
Too short to generate a summarization
5006400Other
TCT_IMAGE_MODERATION_FAILED
Image moderation failed
6000400Other
ASTRO_BOY_FEATURE_DISABLED
Feature disabled
6001400Other
ASTRO_BOY_FEATURE_UPDATE_FAILED
Failed to update feature status
6100409Other
CLOUD_AI_RUNNER_OFFLINE
Runner offline
6101404Other
CLOUD_AI_SANDBOX_GONE
Sandbox is gone
6102503Other
CLOUD_AI_ENDPOINT_UNKNOWN
Runner endpoint unknown
6103429Other
CLOUD_AI_CRASH_LOOP
Sandbox launch failing repeatedly
6104403Other
CLOUD_AI_ORIGIN_REJECTED
Origin rejected
6105403Other
CLOUD_AI_NOT_AVAILABLE
Cloud AI is not available
7000404Other
ARTIFACT_NOT_FOUND
Artifact not found
7001404Other
ARTIFACT_REVISION_NOT_FOUND
Artifact revision not found
7002409Other
ARTIFACT_VERSION_CONFLICT
Artifact was modified by someone else
7003403Other
ARTIFACT_ACTION_NOT_PERMITTED
Artifact action not permitted
7004403Other
ARTIFACT_CAPABILITY_DISABLED
Artifact capability is not enabled
7005400Other
ARTIFACT_CONTENT_REJECTED
Artifact content rejected by security check
7006400Other
ARTIFACT_FORMAT_NOT_SUPPORTED
Artifact format not supported
7007400Other
ARTIFACT_CONTENT_TOO_LARGE
Artifact content too large
7008404Other
ARTIFACT_SHARE_NOT_FOUND
Artifact share not found
7009400Other
ARTIFACT_SHARE_EXPIRY_INVALID
Artifact share expiry invalid
7010404Other
ARTIFACT_GRANT_NOT_FOUND
Artifact grant not found
7011400Other
ARTIFACT_GRANT_SUBJECT_INVALID
Artifact grant subject invalid
7012400Other
ARTIFACT_UPLOAD_VALIDATION_FAILED
Artifact upload validation failed
7013404Other
ARTIFACT_CONTENT_NOT_AVAILABLE
Artifact content not available
7014404Other
ARTIFACT_MANAGED_FILE_ACCESS_DENIED
File not found
7015503Other
ARTIFACT_SANDBOX_NOT_CONFIGURED
Artifact render surface is not configured
7016404Other
ARTIFACT_COMMENT_THREAD_NOT_FOUND
Artifact comment thread not found
7017404Other
ARTIFACT_COMMENT_NOT_FOUND
Artifact comment not found
7018400Other
ARTIFACT_COMMENT_ANCHOR_INVALID
Artifact comment anchor does not match the document
7019400Other
ARTIFACT_COMMENT_UNSUPPORTED_CONTENT
Artifact content does not support anchored comments
7020400Other
ARTIFACT_COMMENT_THREAD_FULL
Artifact comment thread is full
7021400Other
ARTIFACT_COMMENT_MENTION_NOT_PERMITTED
Mentioned user cannot reach this artifact
7022404Other
ARTIFACT_ASSET_NOT_FOUND
Artifact asset not found
7023400Other
ARTIFACT_ASSET_PATH_INVALID
Artifact asset path invalid
7024409Other
ARTIFACT_ASSET_PATH_TAKEN
Artifact asset path already in use
7025400Other
ARTIFACT_ASSET_LIMIT_REACHED
Artifact holds the maximum number of assets
7026429Other
ARTIFACT_JEV_BUDGET_SPENT
Artifact has spent its judgement budget for now
7027503Other
ARTIFACT_JEV_UNAVAILABLE
Judgement service is unavailable

Typical Troubleshooting Flow​

For more detailed scenario-based handling:

Reporting Errors​

Please contact the platform in any of the following situations:

  • An error code not listed in the table
  • A message that is too vague to diagnose
  • A discrepancy between the error code documentation and its actual behavior

When submitting a report, include the code + trace_id + request timestamp — see Request Tracing.


See also​

Self-check