---
title: "Submit Suggestion"
method: POST
path: "/v1/feedback/suggestions"
tags: ["feedback"]
---

# Submit Suggestion

`POST /v1/feedback/suggestions`

## Request

- Base URL: `https://api.usekeel.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.usekeel.io/v1/feedback/suggestions`
- Auth: none declared

Store one in-app suggestion; 201 ``{"id": "fbs_..."}``.

422 ``suggestion_empty`` / ``suggestion_too_long`` / ``suggestion_invalid``
for a refused message (a blank message passes pydantic's length check and
is refused here), 429 ``suggestion_rate_limited`` with ``Retry-After`` when
the principal already sent the window's maximum.

## Headers

- `Authorization` string, nullable
- `X-Org-Id` string, nullable

## Request body

- SuggestionRequest: keel-app's suggestion dialog body. Unknown keys are refused (422).
  - `message` string, required
  - `category` 'idea' | 'bug' | 'other', nullable
  - `page_path` string, nullable
  - `app_version` string, nullable

## Response `201`

Successful Response

- SuggestionCreated
  - `id` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/usekeel/apis/keel-api.md) · [All operations](https://skmtc.dev/usekeel/apis/keel-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usekeel/apis/keel-api/revisions/3191ca10b0ab?raw)