---
title: "Add prompts to a topic cluster"
method: POST
path: "/v3/topic-clusters/{topicId}/prompts"
tags: ["Topic Clusters"]
---

# Add prompts to a topic cluster

`POST /v3/topic-clusters/{topicId}/prompts`

Links existing prompts or creates new ones and attaches them to a topic cluster.

## Path parameters

- `topicId` string, required

## Request body

- object
  - `teamId` string
  - `prompts` object[] — Each item is either { promptId } to link an existing prompt or { prompt, intent, region? } to create a new one. region is the structured country-level object { type, city, state, country, iso2, iso3 }; omit for worldwide.
    - `promptId` string
    - `prompt` string
    - `intent` string
    - `region` object
      - `type` string
      - `city` string
      - `state` string
      - `country` string
      - `iso2` string
      - `iso3` string
  - `intents` object — Map of prompt text → intent override
  - `track` boolean — Whether to enable tracking on newly linked prompts

## Response `200`

Default Response

- object
  - `success` boolean, required
  - `linked` number, required
  - `created` number, required
  - `skipped` number
  - `promptsSkipped` number
  - `alreadyLinked` number
  - `promptIds` string[], required

## Other responses

- `400` — Default Response
- `404` — Default Response
- `409` — Default Response

---

[API](https://skmtc.net/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.net/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/versions/6e50f4761eea/schema)