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

# Handle Cluster Suggestions

`POST /cluster-suggestions`

## 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.net/akk/apis/fastapi.md) · [All operations](https://skmtc.net/akk/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/akk/fastapi/revisions/6662a407c637/schema)