logo
Console
AI Agent
Server
Introduction
Overview
Release Notes
Quick Start
Quick Start Voice Call
Basic
Display Subtitles
Display User And Agent Status
Get AI Agent Status
Configure LLM
Proactive Invocation of LLM and TTS
Configure ASR Hot Word
Interrupt Agent
Advanced
Speech Segmentation Control
AI Short-Term Memory Management
Best Practices
Role-Playing System Prompt
Clone Voice
Interact with AI in IM and make voice calls
API Reference
Overview
Accessing Server APIs
Return Codes
Agent Parameter Description
Agent Configuration Management
Register Agent
Unregister Agent
Update Agent
List Agents
Query Agents Details
Agent Instance Management
Create Agent Instance
Update Agent Instance
Delete Agent Instance
Agent Instance Control
Trigger LLM
Trigger TTS
Query The Status of An AI Agent Instance
Interrupt Agent Instance
Get Agent Instance Context
Reset Agent Instance Context
Callback
Receiving Callback
Exception Event Codes
On this page

Return Codes

Common Return Codes

Return CodeDescriptionSuggested Action
0Success-
100000000Incorrect Host in the request header.Please confirm whether the Host address in the request header is correct.
100000001Incorrect format of AppId field.Please fill in the correct AppId.
100000002Timestamp field is empty.Please fill in the Timestamp.
100000003Incorrect format of Timestamp field.Please fill in the correct Unix timestamp (in seconds).
100000004Signature expired.Please regenerate the signature.
100000005Signature error.Please confirm whether the parameters used to generate the signature are correct.
100000006Action is empty.Please specify the Action.
100000007Unsupported Action.Please fill in the correct Action.
100000008SignatureNonce field is empty.Please fill in the SignatureNonce.
100000009Signature field is empty.Please fill in the Signature.
100000010Failed to get ServerSecret.Please confirm whether the AppId is correct.
100000011Failed to get App configuration.Please confirm whether the AppId is correct, or contact ZEGOCLOUD technical support for assistance.
100000012Failed to read HTTP packet body.Please contact ZEGOCLOUD technical support for assistance.
100000013SignatureVersion field is empty.Please fill in the SignatureVersion.
100000014Unsupported SignatureVersion.SignatureVersion only supports 2.0.
100000015Internal gateway error.Please contact ZEGOCLOUD technical support for assistance.
100000017The App has not enabled this service.Please contact ZEGOCLOUD technical support for assistance.

Business Return Codes

Return CodeDescriptionSuggested Action
410000001System error.Please contact ZEGOCLOUD technical support for handling.
410000002Invalid AppID.Please check if the AppID is correct.
410000003Invalid parameter.Please check the illegal input parameters according to the Message prompt.
410000004JSON parsing failed.Please check if the request parameters are valid JSON.
410000005Gateway authentication failed.Please contact ZEGOCLOUD technical support for handling.
410000006The App has not enabled this service.Please contact ZEGOCLOUD technical support for handling.
410000009Internal service call failed.Please contact ZEGOCLOUD technical support for handling.
410000010Insufficient service resources.Please contact ZEGOCLOUD technical support for handling.
410000011APP online instance concurrency limit.Please check if the concurrency limit has been reached, and contact ZEGOCLOUD technical support for handling.
410001002AI agent instance not found.Please check if the AI agent instance has been deleted.
410001003AI agent instance creation failed.Please contact ZEGOCLOUD technical support for handling.
410001004AI agent instance modification failed.Please contact ZEGOCLOUD technical support for handling.
410001005AI agent instance deletion failed.Please contact ZEGOCLOUD technical support for handling.
410001006Active LLM call failed.Please contact ZEGOCLOUD technical support for handling.
410001007Active TTS call failed.Please contact ZEGOCLOUD technical support for handling.
410001008AI agent already exists.Do not create duplicates.
410001009AI agent not found.Please check if the AI agent has been created.
410001010Failed to load the message history.Please contact ZEGOCLOUD technical support for handling.
410001011AI agent instance update failed.Please contact ZEGOCLOUD technical support for handling.
410001013AI agent is listening.When the AI agent is listening, you can not active trigger LLM or TTS.
410001022Failed to get the agent instance context.Please contact ZEGOCLOUD technical support for handling.
410001023Failed to reset the agent instance context.Please contact ZEGOCLOUD technical support for handling.
410001024Failed to interrupt the agent instance.Please contact ZEGOCLOUD technical support for handling.

Previous

Accessing Server APIs

Next

Agent Parameter Description

On this page

Back to top