---
title: "Create prompts in a workspace"
method: POST
path: "/v1/workspaces/{id}/prompts"
tags: ["Prompts"]
---

# Create prompts in a workspace

`POST /v1/workspaces/{id}/prompts`

Creates one prompt (`prompt`) or several (`prompts`) in the workspace and starts monitoring them, exactly like creation in the UI (including search-volume computation). Up to 5 prompts are created synchronously (201 with the created items); larger batches are processed asynchronously (202 with a processing summary). The whole batch is validated against the workspace's remaining prompt allocation up front — nothing is created if it would exceed the limit.

## Path parameters

- `id` string, required — Workspace identifier.

## Request body

- PublicApiCreatePromptsRequest
  - `prompts` string[], required — Prompt texts to create (same country, tags and brand reports for all). Pass a single-item array to create one prompt.
  - `country` string, required — Country the prompts are monitored in. Lowercase ISO 3166-1 alpha-2; use `uk` for the United Kingdom. Immutable after creation.
  - `tagIds` string[] — Optional tag IDs to assign to every created prompt.
  - `brandReportIds` string[] — Optional brand report IDs to add every created prompt to.

## Response `201`

The created prompts.

- PublicApiCreatedPrompts
  - `items` PublicApiCreatedPrompt[], required
    - `id` string, required
    - `prompt` string, required
    - `country` string, required
    - `tagIds` string[], required
    - `brandReportIds` string[], required
    - `createdDate` string, required

## Other responses

- `202` — Batch accepted; prompts are created asynchronously.
- `400` — Validation failed.
- `401` — Unauthorized.
- `403` — Forbidden.
- `409` — One or more prompts already exist in the workspace for this country.
- `429` — Quota exhausted.

---

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