Skip to main content
GET
List Agent Versions
Integration Prompt for AI Agents
New: GET /v1/agents/{agent_id}/versionsDeprecated: GET /v1/agents/{agent_id}/prompts/versions. Old path, still works.
Lists agent versions with optional filters (label, version).

Headers

X-Organization-Id
string
X-API-Key
string
required

API key required to authenticate requests.

Path Parameters

agent_id
integer
required

Query Parameters

label
string | null
version
integer | null
limit
integer
default:50

Response

Successful Response

prompt_text
string
required

the prompt content

version
integer
required

the version number of the prompt

agent_id
integer
required

id of the agent that owns this prompt

id
string<uuid> | null

the id of the prompt

commit_message
string | null
labels
string[] | null

labels associated with the prompt

metadata
Metadata · object | null

arbitrary JSON metadata