Skip to main content
GET

Authorizations

Authorization
string
header
required

Organization API key passed as a Bearer token. This is the scheme used by the public SDK surface.

Path Parameters

agent_id
string<uuid>
required

A UUID string identifying the base agent.

Query Parameters

organization_id
string<uuid>

Organization ID. This is required for access control. It can be provided via query or request body depending on the endpoint.

Response

Successfully retrieved list of agent versions.

id
string<uuid>
required
read-only
name
string
required
read-only
version_name
string
required

Version name for the agent version. Defaults to 'unnamed version' if not provided.

created_at
string<date-time>
required
read-only
engine_class_id
string
required
read-only

Get engine_class_id from base_agent.

engine_name
string
required
read-only

Engine Display Name

input_definitions
object[]
required

List of input definitions for this agent version.

engine_config
any
required

Engine configuration.

organization_id
string<uuid>
required
read-only

Organization ID from base_agent.

readonly
boolean
required
read-only
base_agent
object
required

Serializer for BaseAgent (agent config)

creator
object | null
description
string

Description of the agent version.