Thread ID (thr_...). Must belong to the authenticated user's workspace.
Successful response
Update thread settings
Updates the settings for the specified thread. Only fields included in
the settings map are modified; omitted fields retain their current values.
The authenticated user must own the thread or be a member of its workspace.
Returns the full settings object reflecting the state after the update.
Validation errors are returned as 422 Unprocessable Entity.
Thread ID (thr_...). Must belong to the authenticated user's workspace.
Request body.
Map of settings fields to update. Include only the keys you want to change.
The thread settings object after the update has been applied.
Retrieve thread settings Returns the current settings for the specified thread. Settings control per-thread behavior such as whether the AI agent is enabled. The authenticated user must own the thread or be a member of its workspace. If settings have never been explicitly configured, defaults are returned (for example,
agent_enableddefaults totrue).