SEsearchable
Prompts

Archive or restore a prompt

Changed on

Archive or restore a prompt, as the app's Archive and Restore actions do. action: "archive" stops tracking it and keeps its history and metrics; action: "restore" tracks it again, within the prompt allowance. Prompts added through this API are tracked already and need no restore. Requires the prompt:activate capability. A stale expectedRevision returns 409 stale_revision; a pitch project that is not currently active refuses with 409 INACTIVE_PITCH_PROMPT_MUTATION. Supports Idempotency-Key replay; a reused key with a different body returns 409 idempotency_conflict.

post/api/mcp/projects/{projectId}/prompts/{promptId}/tracking

Request

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

Path parameters

projectIdstring uuid required

The project id.

promptIdstring uuid required

The prompt's id, as list_prompts prints it. These routes change a prompt or read its history, so they take the id only: no prefix or text lookup, and a value that is not a UUID is 404.

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

action'archive' | 'restore' required
expectedRevisioninteger

Response

Prompt tracking state changed.

successboolean required

Changes