AI Agent

Public Agents

GEThttps://openapi.longbridge.com/v1/ai/agents

Authorization

Signed mode: every request is signed with your App Key/Secret. Header set:

NameTypeRequiredDescription
Authorizationstring · headerRequiredThe account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation.
X-Api-Keystring · headerRequiredYour App Key.
X-Timestampstring · headerRequiredRequest timestamp in seconds (Unix epoch).
X-Api-Signaturestring · headerRequiredHMAC-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

NameTypeRequiredDescription
pageintegerOptionalPage number, starts at 1, default 1
limitintegerOptionalPage size, default 20, maximum 50

Response

Response properties

NameTypeRequiredDescription
agentsobject[]OptionalAgent list, ordered by last updated time descending
└ uidstringOptionalAgent UID, used as the path parameter of [Start Conversation](/docs/ai/chat/conversation)
└ namestringOptionalAgent name, localized by the `Accept-Language` header
└ descriptionstringOptionalAgent description, localized by the `Accept-Language` header
└ modestringOptionalAgent mode, e.g. `chat`
└ iconstringOptionalIcon URL
└ is_publishedbooleanOptionalAlways `true` for this endpoint
└ published_atintegerOptionalPublish time, Unix timestamp in seconds
└ created_atintegerOptionalCreation time, Unix timestamp in seconds
└ updated_atintegerOptionalLast updated time, Unix timestamp in seconds
totalintegerOptionalTotal 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.