---
title: "Create suggestion"
method: POST
path: "/api/v1/suggestions"
tags: ["Comments & Suggestions "]
---

# Create suggestion

`POST /api/v1/suggestions`

## Request

- Base URL: `https://api.simplelocalize.io`
- URL: `https://api.simplelocalize.io/api/v1/suggestions`
- Auth: one of:
  - API key in header `X-SimpleLocalize-Token`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/simplelocalize/apis/simplelocalize-api/docs/api/v1/suggestions/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new translation suggestion for a given key and language.

The `Authorization` header with a Personal Access Token is optional here — if the project
has anonymous suggestions enabled for the given language, the suggestion is created without
attributing it to any user.

## Headers

- `X-SimpleLocalize-Token` string, required
- `Authorization` string

## Request body

- ApiSuggestionCreateRequest
  - `namespace` string: Namespace of the translation key
  - `key` string, required: Translation key
  - `language` string, required: Language key the suggestion is for
  - `suggestedTranslation` string, required: Suggested translation text
  - `content` string, required: Comment explaining the suggestion

## Response `200`

OK

## Other responses

- `400`: Bad Request
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

- **2026-11-07** `67a25a25863a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/changes/api/v1/suggestions/post.md)

---

[API](https://skmtc.dev/simplelocalize/apis/simplelocalize-api.md) - [All operations](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/llms.txt) - [OpenAPI document](https://skmtc.dev/simplelocalize/apis/simplelocalize-api/revisions/67a25a25863a?raw)