---
title: "Search context items within a thread"
method: GET
path: "/api/v1/threads/{thread}/search"
---

# Search context items within a thread

`GET /api/v1/threads/{thread}/search`

Performs a full-text search over context items (messages, files, and other
indexed sources) attached to the specified thread. Returns tagged objects
whose content matches the query string.

Use the `type` param to restrict results to a particular context source. All
accessible context source types are searched when `type` is omitted. The
authenticated user must have access to the thread.

## Path parameters

- `thread` string, required

## Query parameters

- `type` string
- `q` string, required

## Response `200`

Successful response

- object — Search results for the query.
  - `data` object[], required — Array of matching context items. Each item is a tagged object whose shape depends on the source type.

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