Agents

Update Agent

Update an AI voice agent's configuration.

Overwrites the fields you send; omitted fields keep their values and the old values are not kept. Changes apply to the next inbound or outbound call the agent handles; calls already in progress are unaffected.

Returns the full updated agent. Sending no fields, an unknown voice_id or a transfer_number other than owner_phone returns HTTP 400.

patch/v1/agents/{agent_id}

Request

  • Base URL: https://api.agentline.cloud
  • URL: https://api.agentline.cloud/v1/agents/{agent_id}
  • Auth: HTTP bearer

Path parameters

agent_idstring required

Agent ID (agt_...) returned by create_agent or list_agents.

Request body

namestring nullable

New display name for the AI voice agent

system_promptstring nullable

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

initial_greetingstring nullable

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

voice_idstring nullable

New TTS voice preset name or voice UUID

transfer_numberstring nullable

Number a live call is transferred to. Only the owner phone is allowed, so send the same E.164 number as owner_phone (current or in this request); setting owner_phone updates it automatically.

voicemail_messagestring nullable

Updated voicemail message

owner_phonestring nullable

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

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.