AI Agent
Authorization
Signed mode: every request is signed with your App Key/Secret. Header set:
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string · header | Required | The account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation. |
X-Api-Key | string · header | Required | Your App Key. |
X-Timestamp | string · header | Required | Request timestamp in seconds (Unix epoch). |
X-Api-Signature | string · header | Required | HMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=. |
List all publicly available Agents on the platform — the same catalog shown on the Explore page. The returned uid is the Agent identifier used in the Start Conversation endpoint path.
Unlike Agents in Workspace, this endpoint is not scoped to a Workspace: it returns every Agent that is published and publicly shared.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
page | integer | Optional | Page number, starts at 1, default 1 |
limit | integer | Optional | Page size, default 20, maximum 50 |
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
agents | object[] | Optional | Agent list, ordered by last updated time descending |
└ uid | string | Optional | Agent UID, used as the path parameter of [Start Conversation](/docs/ai/chat/conversation) |
└ name | string | Optional | Agent name, localized by the `Accept-Language` header |
└ description | string | Optional | Agent description, localized by the `Accept-Language` header |
└ mode | string | Optional | Agent mode, e.g. `chat` |
└ icon | string | Optional | Icon URL |
└ is_published | boolean | Optional | Always `true` for this endpoint |
└ published_at | integer | Optional | Publish time, Unix timestamp in seconds |
└ created_at | integer | Optional | Creation time, Unix timestamp in seconds |
└ updated_at | integer | Optional | Last updated time, Unix timestamp in seconds |
total | integer | Optional | Total number of public Agents matching the query |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"agents": [
{
"uid": "ag_7d3f9b2c",
"name": "US Stock Analyst",
"description": "Answers US stock questions with market and fundamental data",
"mode": "chat",
"icon": "https://cdn.longbridge.com/icons/agent.png",
"is_published": true,
"published_at": 1742000000,
"created_at": 1741000000,
"updated_at": 1742001000
}
],
"total": 35
}
}Error code
See the Error Codes page for the full list of error codes.