---
title: "Suggest a different translation for one slot"
method: POST
path: "/api/v1/feedback/translations/{lang}/{termId}/suggestions"
tags: ["Feedback"]
---

# Suggest a different translation for one slot

`POST /api/v1/feedback/translations/{lang}/{termId}/suggestions`

## Request

- Base URL: `https://glossary.ethereum.org`
- URL: `https://glossary.ethereum.org/api/v1/feedback/translations/{lang}/{termId}/suggestions`
- Auth: API key in cookie `ethglossary-session`
- TypeScript: <https://skmtc.dev/ethereum/apis/ethglossary-api/docs/api/v1/feedback/translations/:lang/:termId/suggestions/post.ts> (a function with typed inputs; its response is checked against the schema)

Visible only to you and to the maintainers. Suggesting the same value twice is a no-op that reports `duplicate: true`. Requires a session cookie.

## Path parameters

- `lang` string, required: Language code (e.g., es, ja, zh-tw)
- `termId` string, required: Term ID, alias, or variant (intelligent matching)

## Request body

- FeedbackSuggestion
  - `context` 'prose' | 'heading' | 'tag' | 'ui' | 'plurals', required: The translation slot the feedback is about
  - `hash` string, required: Content hash of the value as rendered; the server refuses with 409 if it no longer matches
  - `value` string, required: Up to 200 characters, except plurals: `category=form` pairs joined by `|`, up to 100 per form
  - `reason` string: Why this is better. Optional.

## Response `201`

Recorded

- FeedbackSuggestionResponse
  - `id` string, uuid, required
  - `duplicate` boolean, required: True when you had already suggested this exact value

## Other responses

- `400`: Suggestion equals the current value
- `401`: Not signed in
- `403`: Cross-origin request
- `404`: Unknown term or language
- `409`: The value changed since the page loaded; reload
- `415`: Body is not application/json
- `429`: Too many writes; wait
- `503`: Database unavailable

---

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