Skip to main content
GET
Get an agent

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

Response

Get an agent

config
ManagedAgentConfig · object
required

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

created_at
string<date-time>
required

An RFC 3339 / ISO 8601 date-time string with timezone (e.g. 2025-04-16T12:34:56.789Z).

description
string | null
required

Description of the agent.

id
string
required

Unique identifier for the agent.

Minimum string length: 1
name
string
required

Name shown for the agent.

updated_at
string<date-time>
required

An RFC 3339 / ISO 8601 date-time string with timezone (e.g. 2025-04-16T12:34:56.789Z).

version
object
required