---
title: "Retrieve thread settings"
method: GET
path: "/api/v1/threads/{thread}/settings"
---

# Retrieve thread settings

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

## Path parameters

- `thread` string, required

## Response `200`

Successful response

- object — The settings for the requested thread.
  - `agent_enabled` boolean — Whether the AI agent is active for this thread. Defaults to `true` when no settings have been explicitly set.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Thread not found

---

[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)