---
title: "Add prompts to a brand report"
method: POST
path: "/v1/reports/brand/{reportId}/prompts"
tags: ["Brand Reports"]
---

# Add prompts to a brand report

`POST /v1/reports/brand/{reportId}/prompts`

## Request

- Base URL: `https://data.otterly.ai`
- URL: `https://data.otterly.ai/v1/reports/brand/{reportId}/prompts`
- Auth: HTTP bearer

Adds prompts that already exist in the report workspace to the brand report, exactly like ticking the report in the UI. It does not create prompts — use `POST /v1/workspaces/{id}/prompts` for that. Prompt IDs already assigned to the report are returned in `alreadyAssigned` and left unchanged; unknown prompt IDs are rejected with a 400 naming them. The report is recalculated for the added prompts asynchronously, so their data appears with a delay. A prompt that was previously removed from this report is reprocessed for the most recent 7 days of citation history only.

## Path parameters

- `reportId` string, required: Brand report identifier.

## Request body

- PublicApiAddBrandReportPromptsRequest
  - `promptIds` string[], required: IDs of prompts that already exist in the report workspace — look them up with `GET /v1/workspaces/{id}/prompts`. Up to 1000 IDs per call. Duplicate IDs are removed, and the de-duplicated list comes back as `promptIds` in the response.

## Response `200`

The prompts assigned to the brand report. Recalculation completes asynchronously.

- PublicApiAddBrandReportPromptsResponse
  - `reportId` string, required
  - `promptIds` string[], required: The prompt IDs the request asked to assign.
  - `added` string[], required: Prompt IDs newly assigned to the report by this request.
  - `alreadyAssigned` string[], required: Prompt IDs that were already assigned to the report, left unchanged.

## Other responses

- `400`: Validation failed.
- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: Report not found.
- `429`: Quota exhausted.

## Changes

- **2026-11-03** `b5dc4bea6d45`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/otterly/apis/otterly-public-api/changes/v1/reports/brand/:reportId/prompts/post.md)

---

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