Last updated at: 2026-10-13

Query Agent Version List

Supports querying the version history list of a target Agent.

This endpoint authenticates with the target Agent's own API Key, and can only be called by an Agent that has version management permission enabled.

Request Method

GET

Request URL

https://altatech.ai/v1/agent/version/list

Request Authentication

Refer to API Overview for authentication instructions. Please use the target Agent's API Key as the token.

Request

Request Example

curl -X GET 'https://altatech.ai/v1/agent/version/list' \
-H 'Authorization: Bearer ${token}'

Request Headers

Field	Type	Description
Authorization	Bearer ${token}	Use the target Agent's API Key for call authentication.

Request Parameters

None.

Response

Response Example

{
    "code": 0,
    "message": "OK",
    "data": [
        {
            "id": "bv-xxxx",
            "bot_id": "bot-xxxx",
            "create_time": 1786327712000,
            "release_time": 1786327812000,
            "version": "v2",
            "version_desc": "Update prompt and tools",
            "version_status": "PUBLISHED",
            "creator_email": "owner@example.com"
        }
    ]
}

Success Response

Field	Type	Description
id	String	Version record ID.
bot_id	String	Agent ID.
create_time	Long	Version creation time, millisecond timestamp.
release_time	Long	Publish time, millisecond timestamp; empty if not published.
version	String	Version number.
version_desc	String	Version description.
version_status	String	Version status.
creator_email	String	Creator's email.

Failure Response

Field	Type	Description
code	int	Error code.
message	string	Error message.

Status Codes

Status Code	Description
200	Success
401	Unauthorized
403	Insufficient permissions, or the API Key does not have version management permission enabled
429	Too many requests
500	Server error