---
title: "Accept suggested prompts"
method: POST
path: "/suggested_prompts/accept"
tags: ["Prompts"]
---

# Accept suggested prompts

`POST /suggested_prompts/accept`

## Request

- Base URL: `https://api.llmpulse.ai/api/v1`
- URL: `https://api.llmpulse.ai/api/v1/suggested_prompts/accept`
- Auth: API key in header `Authorization`

Starts tracking up to 100 pending suggestions: each becomes a prompt in its own country and language, optionally put in one tag (tag_ids or tag_names; create_missing creates a missing name when the team member may create tags). Suggestions that are no longer pending come back in skipped. When the new prompts would exceed the plan the call returns ERR_LIMIT_REACHED and accepts nothing. The prompts of a launched pitch project are fixed, so accepting a suggestion returns ERR_INVALID_PARAM with error.meta.reason pitch_prompts_frozen. Requires a `read_write` scope API key and, for team members, create access to Prompts.

## Request body

- SuggestedPromptsAcceptRequest
  - `project_id` integer, required
  - `ids` integer[], required: Suggestion ids to accept (max 100)
  - `tag_ids` integer[]: One tag id to put the new prompts in
  - `tag_names` string[]: One tag name (case-insensitive) to put the new prompts in
  - `create_missing` boolean: Create the tag named in tag_names when it does not exist

## Response `200`

Accepted and skipped suggestions

- SuggestedPromptsAcceptResponse
  - `project_id` integer, required
  - `accepted` object[], required
    - `suggestion_id` integer, required
    - `prompt_id` integer, required
    - `collection_id` integer, nullable, required: The tag the prompt was put in; null when no tag was given
  - `skipped` object[], required
    - `suggestion_id` integer, required
    - `reason` string, required: accepted or rejected (the suggestion was no longer pending), or pending_deletion
  - `prompts_available` integer, nullable, required: Prompt slots left on the plan; null when unlimited
  - `request_id` string, required

## Other responses

- `403`: API key lacks write permission
- `404`: Resource not found
- `422`: Invalid parameters

## Changes

- **2026-10-16** `dd090b1e1154`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/llmpulse/apis/llm-pulse-api/changes/suggested_prompts/accept/post.md)

---

[API](https://skmtc.dev/llmpulse/apis/llm-pulse-api.md) - [All operations](https://skmtc.dev/llmpulse/apis/llm-pulse-api/llms.txt) - [OpenAPI document](https://skmtc.dev/llmpulse/apis/llm-pulse-api/revisions/38a31f123641?raw)
