v1

latestOpenAPI 3.0.02026-08-04891301.4 MB

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_enabled defaults to true).

get/api/v1/threads/{thread}/settings

Path parameters

threadstring required

Thread ID (thr_...). Must belong to the authenticated user's workspace.

Response

Successful response

agent_enabledboolean

Whether the AI agent is active for this thread. Defaults to true when no settings have been explicitly set.

Example response

{
  "agent_enabled": true
}