---
title: "Get Intent Clusters"
method: GET
path: "/corpus/adapters/{adapter_id}/clusters"
tags: ["corpus"]
---

# Get Intent Clusters

`GET /corpus/adapters/{adapter_id}/clusters`

## Request

- Base URL: `https://app.teetra.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.teetra.com/corpus/adapters/{adapter_id}/clusters`
- Auth: none declared

Top intent clusters by embedding similarity — sizes and outcome mix only.

## Path parameters

- `adapter_id` string, required

## Query parameters

- `similarity_threshold` number
- `max_clusters` integer
- `owner_id` string, nullable: Optional caller-asserted owner id (must match authenticated producer)

## Response `200`

Successful Response

- CorpusClustersResponse
  - `adapter_id` string, required
  - `embeddable_events` integer, required
  - `num_clusters` integer, required
  - `clusters` CorpusClusterStat[]
    - `size` integer, required
    - `dominant_outcome` string, required
    - `outcomes` object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/teetra/apis/warrant.md) · [All operations](https://skmtc.dev/teetra/apis/warrant/llms.txt) · [OpenAPI document](https://skmtc.dev/teetra/apis/warrant/revisions/a33505db716f?raw)