---
title: "Update thread settings"
method: PUT
path: "/api/v1/threads/{thread}/settings"
---

# Update thread settings

`PUT /api/v1/threads/{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`.

## Path parameters

- `thread` string, required

## Request body

- object
  - `settings` object, required — Map of settings fields to update. Include only the keys you want to change.

## Response `200`

Successful response

- ThreadSettings — Configuration settings for a thread that control AI agent behavior and other thread-level preferences.
  - `agent_enabled` boolean — Whether the AI agent is active for this thread. `true` enables AI responses; `false` disables them. Defaults to `true` when settings have not been explicitly configured.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Thread not found
- `422` — Validation error

---

[API](https://skmtc.net/archastro/apis/archastro-platform-api.md) · [All operations](https://skmtc.net/archastro/apis/archastro-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/archastro/archastro-platform-api/versions/a8772b442f86/schema)