Skip to main content
GET
Get an agent version

Authorizations

Authorization
string
header
default:$CARTESIA_API_KEY
required

Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.

Headers

Cartesia-Version
enum<string>
default:2026-08-14
required

API version header.

Available options:
2026-08-14
Example:

"2026-08-14"

Path Parameters

agent_id
string
required

Unique identifier for the agent.

Minimum string length: 1
version_id
string
required

Unique identifier for an immutable agent configuration version.

Minimum string length: 1

Response

Get an agent version

An immutable snapshot of an agent's configuration.

config
ManagedAgentConfig · object
required

Complete configuration for the agent's model, language, audio, and tools.

created_at
string<date-time>
required

Time when this version was created.

created_by
string | null
required

ID of the user or API key that created this version. null when no creator was recorded.

Minimum string length: 1
description
string | null
required

Description supplied when this version was created. null if none was provided.

id
string
required

Unique identifier for an immutable agent configuration version.

Minimum string length: 1