Change the model
Authorization
host AuthorizationBearer <token>
Checked by host({authenticate}), which maps the request to a Principal or rejects it.
In: header
Path Parameters
thread_id*string
Lowercase UUID string. Writers MUST generate UUIDv7; readers accept any lowercase UUID, so the version is not an admission rule.
Match
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$Query Parameters
branch_id?string
Default: the thread's main branch.
Match
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
An operator settings change. The host resolves model to the model factory named in the agent's model or fallback list; adapter settings come from that factory.
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/threads/string/settings" \ -H "Content-Type: application/json" \ -d '{ "model": { "name": "string", "provider": "string" } }'{ "event_id": "string"}