---
title: "Handle Cluster Suggestions"
method: POST
path: "/cluster-suggestions"
---

# Handle Cluster Suggestions

`POST /cluster-suggestions`

## Request

- Base URL: `https://api.akkio.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.akkio.com/cluster-suggestions`
- Auth: none declared

## Request body

- ClusterSuggestionsRequestPayload
  - `datasetId` string, required: ID of the dataset to get clustering suggestions for
  - `guidance` string, nullable: Optionally provided guidance as to what clusters the user wants to create.
  - `suggestions` string[]: Existing suggestions we should use as additional context in order to generate the rest.

## Response `201`

Successful Response

- ClusterSuggestionsResponsePayload
  - `categories` string[], required
  - `on_columns` string[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/akkio/apis/akkio-api.md) - [All operations](https://skmtc.dev/akkio/apis/akkio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/akkio/apis/akkio-api/revisions/c477deff6271?raw)