---
title: "Update tracked prompt"
method: PATCH
path: "/ai-visibility/prompts/{id}"
tags: ["AI Visibility"]
---

# Update tracked prompt

`PATCH /ai-visibility/prompts/{id}`

## Request

- Base URL: `https://next.frase.io/api/v1`
- URL: `https://next.frase.io/api/v1/ai-visibility/prompts/{id}`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

Update prompt status, frequency, or platforms.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `status` 'active' | 'paused' | 'archived'
  - `frequency` 'daily' | 'weekly' | 'manual'
  - `platforms` string[]
  - `brand_variants` string[]

## Response `200`

Prompt updated

- object
  - `data` object
    - `id` string, uuid
    - `status` string
    - `frequency` string
    - `platforms` string[]
    - `updated_at` string, date-time
  - `request_id` string

## Other responses

- `429`: Org-wide active-prompt cap reached (ai_prompt_limit_exceeded). Returned when creating an active prompt, or when a PATCH transitions a prompt's status to active. The cap counts concurrently active prompts, not monthly usage. Pause a prompt to free a slot, or upgrade your plan.

---

[API](https://skmtc.dev/frase/apis/frase-api.md) · [All operations](https://skmtc.dev/frase/apis/frase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frase/apis/frase-api/revisions/7fb75d89f7a4?raw)