---
title: "Update Prompt Suggestions"
method: POST
path: "/prompts/suggestions/update"
tags: ["Project"]
---

# Update Prompt Suggestions

`POST /prompts/suggestions/update`

## Request

- Base URL: `https://api.peec.ai/customer/v1`
- URL: `https://api.peec.ai/customer/v1/prompts/suggestions/update`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`
  - HTTP bearer

Edit pending Prompt discovery suggestions (`pr_`) before accepting them: rewrite the text and/or replace the tag set per item. Editing keeps a suggestion pending — accept it to create the tracked prompt. Each item is independent: unknown ids are reported in `skipped`, and unsatisfiable items (a standard `ps_` suggestion, an unknown tag, a duplicate id, nothing to change) in `rejected`, so the batch never fails as a whole.

## Request body

- object
  - `project_id` string: Required if using a company api key
  - `suggestions` object[], required
    - `prompt_suggestion_id` string, required: The suggestion to edit, from GET /prompts/suggestions.
    - `text` string: New prompt text, replacing the suggestion's current text.
    - `tag_ids` string[]: New tag set, replacing the suggestion's existing tags. Each id must be an existing tag in the project.

## Response `200`

Per-item update results

- object: Per-item update results
  - `updated` object[], required
    - `prompt_suggestion_id` string, required
  - `skipped` object[], required
    - `prompt_suggestion_id` string, required
    - `reason` 'not_found', required
  - `rejected` object[], required
    - `prompt_suggestion_id` string, required
    - `reason` 'not_editable' | 'invalid_tag' | 'duplicate_id' | 'no_changes', required
    - `message` string, required

## Other responses

- `400`: Response for status 400

## Changes

- **2026-11-03** `9fdffdff48a5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/peec/apis/peec-ai-customer-api/changes/prompts/suggestions/update/post.md)

---

[API](https://skmtc.dev/peec/apis/peec-ai-customer-api.md) - [All operations](https://skmtc.dev/peec/apis/peec-ai-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/peec/apis/peec-ai-customer-api/revisions/9d774600c8eb?raw)