> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rocketblue.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Move prompts to topic

> Move multiple prompts to a different topic in one request.

Moves prompts to another topic and updates related historical data (analysis results, response links, content suggestions, and generated content ideas) so reporting stays consistent.

All prompts must belong to the **same brand**. The destination topic must belong to that brand.

### Request body

<ParamField body="promptIds" type="string[]" required>
  Non-empty array of prompt UUIDs to move.
</ParamField>

<ParamField body="topicId" type="string" required>
  Destination topic UUID.
</ParamField>

### Request

```bash theme={null}
curl -s -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "promptIds": ["PROMPT_ID_1", "PROMPT_ID_2"],
    "topicId": "TOPIC_ID"
  }' \
  "https://app.rocketblue.ai/api/v1/prompts/move-to-topic"
```

### Response

<ResponseField name="topicId" type="string">
  Destination topic ID.
</ResponseField>

<ResponseField name="brandId" type="string">
  Brand the prompts belong to.
</ResponseField>

<ResponseField name="movedPromptIds" type="string[]">
  Prompt IDs included in the request.
</ResponseField>

<ResponseField name="movedCount" type="integer">
  Number of prompts in the request.
</ResponseField>

<ResponseField name="updatedPrompts" type="integer">
  Prompt rows whose `topic_id` changed.
</ResponseField>

<ResponseField name="updatedAnalysisResults" type="integer">
  Historical analysis result rows updated.
</ResponseField>

<ResponseField name="updatedResponseLinks" type="integer">
  Response link rows updated.
</ResponseField>

<ResponseField name="updatedContentSuggestions" type="integer">
  Content suggestion rows updated.
</ResponseField>

<ResponseField name="updatedGeneratedContentIdeas" type="integer">
  Generated content idea rows updated.
</ResponseField>

```json theme={null}
{
  "topicId": "topic-uuid-2",
  "brandId": "brand-uuid-123",
  "movedPromptIds": ["prompt-uuid-1", "prompt-uuid-2"],
  "movedCount": 2,
  "updatedPrompts": 2,
  "updatedAnalysisResults": 48,
  "updatedResponseLinks": 120,
  "updatedContentSuggestions": 0,
  "updatedGeneratedContentIdeas": 0
}
```