Agents

Update an agent

Changed on Mar 24, 2026

Partially updates an agent. Only the fields you include are modified.

Set knowledge_base_id to null to detach the current knowledge base.

patch/v2/agents/{uid}

Request

Base URL
https://api.openmic.ai
URL
https://api.openmic.ai/v2/agents/{uid}
Auth
HTTP bearer

Request body

namestring

promptstring

first_messagestring

Cannot be combined with auto_first_message: true.

auto_first_messageboolean

knowledge_base_idinteger nullable

Set to null to detach the current knowledge base.

voice_provider'OpenAI' | 'ElevenLabs' | 'Deepgram' | 'Cartesia'

voicestring

voice_modelstring

voice_speednumber

llm_model_namestring

llm_model_temperaturenumber

llm_max_tokensinteger

stt_provider'Deepgram'

stt_modelstring

auto_end_callboolean

boosted_keywordsstring[]

selected_jargonsstring[]

Response

Updated agent.

uidstring required

Unique agent identifier (slug/UUID).

namestring required

promptstring required