Skip to main content
curl -X PATCH https://api.thinnest.ai/v2/agents/{public_id} \
  -H "Authorization: Bearer $THINNESTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Updated Agent Name",
  "model": "gpt-4o-mini",
  "instructions": "You are an updated assistant with new behavior."
}'

Path Parameters

agent_id
string
required
The agent’s public ID (ag_*)

Request Body

All fields are optional. Only provided fields are updated — everything else remains unchanged.
name
string
Agent display name
model
string
LLM model identifier (see Supported Models)
instructions
string
System prompt
description
string
Internal description

Response 200

Returns the full updated agent object (same structure as Get Agent).
{
  "id": "ag_c47e7c97_b2f2",
  "name": "Updated Agent Name",
  "createdAt": "2026-03-07T10:00:00Z",
  "updatedAt": "2026-03-07T12:30:00Z",
  "model": {
    "provider": "openai",
    "model": "gpt-4o-mini",
    "temperature": null,
    "maxTokens": null,
    "instructions": "You are an updated assistant with new behavior."
  },
  "transcriber": null,
  "voice": null,
  "tools": [],
  "knowledgeBase": null,
  "voiceEnabled": false,
  "agentType": "simple"
}

Voice configuration

The voice object accepts the full voice agent surface — cascaded TTS, Speech-to-Speech (Gemini Live or OpenAI Realtime), noise cancellation, audio ambience, and BYOK options. See the dedicated Voice Config Reference for every field.

Errors

CodeDescription
401Missing or invalid authentication
403Not authorized to update this agent
404Agent not found
422Invalid request body