Skip to main content
PATCH
Update Agent

Authorizations

Authorization
string
header
required

AgentLine API key. Get one via the email OTP flow (POST /v1/auth/otp then POST /v1/auth/verify). Pass as: Authorization: Bearer al_live_... (legacy sk_live_... still works).

Path Parameters

agent_id
string
required

Body

application/json
name
string | null

New display name for the AI voice agent

system_prompt
string | null

Updated default instructions for ALL future calls (does not affect calls already in progress)

initial_greeting
string | null

Updated default greeting for ALL future calls (inbound and outbound)

voice_id
string | null

New TTS voice preset name or Cartesia voice UUID

transfer_number
string | null

Must match owner_phone. A different number is rejected; setting owner_phone updates this to the same number.

voicemail_message
string | null

Updated voicemail message

owner_phone
string | null

Updated owner phone in E.164. Also becomes the only live-call transfer destination.

Response

Successful Response