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 Workspaces the current account belongs to. A Workspace is the organizational unit for Agents: find the target Workspace via this endpoint first, then use Agents in Workspace to list the Agents available in it.
Request
This endpoint takes no request parameters.
Response
Response properties
| Name | Type | Required | Description |
|---|---|---|---|
workspaces | object[] | Optional | Workspaces the current account belongs to |
└ id | string | Optional | Workspace ID |
└ name | string | Optional | Workspace name |
└ created_at | integer | Optional | Creation time, Unix timestamp in seconds |
└ updated_at | integer | Optional | Last updated time, Unix timestamp in seconds |
Response JSON example
{
"code": 0,
"message": "success",
"data": {
"workspaces": [
{
"id": "1001",
"name": "My Workspace",
"created_at": 1742000000,
"updated_at": 1742001000
}
]
}
}Error code
See the Error Codes page for the full list of error codes.