---
title: "Turn an AEO prompt on or off"
method: PATCH
path: "/api/projects/{project_id}/aeo_prompts/{id}/"
tags: ["web_analytics", "aeo_prompts"]
---

# Turn an AEO prompt on or off

`PATCH /api/projects/{project_id}/aeo_prompts/{id}/`

## Request

- Base URL: `https://us.posthog.com`
- URL: `https://us.posthog.com/api/projects/{project_id}/aeo_prompts/{id}/`
- Auth: HTTP bearer

## Path parameters

- `id` string, required
- `project_id` string, required

## Request body

- PatchedAEOPromptUpdateRequest
  - `active` boolean: Turn the prompt on or off for future runs.

## Response `200`

- AEOPrompt
  - `id` string, required: Prompt id.
  - `prompt` string, required: The question asked to the answer engines, as a user would phrase it.
  - `topic` string, required: Theme the prompt belongs to. The runner alternates between topics on each run.
  - `prompt_source` string, required: Where the prompt came from: 'imported' or 'manual'.
  - `rank` number, double, required: Seeding score. Within a topic, higher runs first.
  - `active` boolean, required: Only active prompts are run against the answer engines.
  - `last_checked_at` string, date-time, nullable, required: When the runner last ran this prompt. Null when it never ran.
  - `external_visibility` number, double, nullable, required: Share of answers (0-100) that mention the brand for this prompt, as reported by the tool the prompt set came from. Kept to benchmark against our own citation rate. Null when the import carried none.
  - `created_at` string, date-time, required: When the prompt was added.
  - `updated_at` string, date-time, nullable, required: When the prompt last changed.

## Changes

> 53 revisions in range; 1 not diffed.

- **2026-10-16** `581a899e6395`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/posthog/apis/posthog-api/changes/api/projects/:project_id/aeo_prompts/:id/patch.md)

---

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