Skip to main content
POST

Overview

Creates a minimal agent (title, description, external_id) under the given organization. For creating an agent with full configuration (voice, prompts, model, etc.) use POST /v1/agents instead. The agent is created with the standard Cartesia voice (Katie – Friendly Fixer) on the sonic-3.5 model. Update the voice later via PUT /v1/agents/{id} or in the dashboard.

Path Parameters

string
required
Organization ID (UUID) to create the agent under

Request Body

string
required
Name of the agent (1–255 characters)
string
Description of what the agent does (max 1000 characters)
string
External identifier for integration with your systems (max 255 characters)

Response Fields