Prompts

Add 1-10 validated Prompt Universe candidates to the project as tracked prompts (isTracked: true), as when you add prompts in the app: the project's next scheduled run checks them, within the prompt allowance. Starts no Prompt Universe run and calls no model. THE GATES AND THE ALLOWANCE ARE ALL-OR-NOTHING, THE WRITES ARE NOT: every candidate is checked before anything is written and one refusal refuses the whole batch with 422 prompt_gates_failed and nothing created; the whole batch is then checked against the prompt allowance, and one that does not fit is refused with 403 quota_exceeded and nothing created. Once writing starts each prompt commits on its own and re-checks your prompt quota, so a batch can still stop partway if another write takes the room. Every response - success or failure - carries outcomes, one row per submitted candidate (created / failed / not_attempted); on a partial failure the response keeps the underlying error's own status and code (for example 403 quota_exceeded) and adds created and outcomes, so retry only the rows that are not created. Any topicIds must belong to the same project as the prompt; one that does not is refused with 404 not_found, indistinguishable from a topic id that does not exist. Requires a connection minted with the prompt:draft capability (not the bare write scope), and your own project role must allow the write. Supports Idempotency-Key replay. Returns 404 where the feature is not enabled for the workspace.

post/api/mcp/projects/{projectId}/prompt-generation/import

Request

  • Base URL
    https://app.searchable.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring uuid required

The project id.

Headers

Idempotency-Keystring

Optional client-generated key (e.g. a UUID). Retrying with the same key within 24h replays the original stored response (X-Idempotent-Replay: true) instead of repeating the side effect. See Idempotency.

Request body

marketstring

Which spelling list to hold the set to (US or GB).

Response

The added prompts.

createdinteger required
successboolean required

Changes