---
title: "Update a phrase"
method: PUT
path: "/api/v1/phrases/{phraseId}"
tags: ["Phrases"]
---

# Update a phrase

`PUT /api/v1/phrases/{phraseId}`

## Request

- Base URL: `https://api.multilocale.com`
- URL: `https://api.multilocale.com/api/v1/phrases/{phraseId}`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`
  - OAuth 2 (authorization code, authorization URL `https://app.multilocale.com/oauth/authorize`, token URL `https://api.authrice.com/api/oauth/token`, scopes: `phrases:write`)

Replaces a phrase you own and emits `phrase.updated`. Answers 404 — not 403 — for a phrase belonging to another organization, so ids cannot be probed. Requires the `phrases:write` scope. Send `Idempotency-Key` to make retries safe for 24 hours.

## Path parameters

- `phraseId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- Phrase
  - `key` string
  - `value` string
  - `language` string
  - `projects` string[]: Project names this phrase belongs to

## Response `200`

The updated phrase

- Phrase
  - `key` string
  - `value` string
  - `language` string
  - `projects` string[]: Project names this phrase belongs to

## Other responses

- `401`: Missing or invalid credentials
- `403`: API key is missing the `phrases:write` scope
- `404`: No such phrase in your organization
- `409`: Idempotency key is in flight or was reused with different input
- `429`: API key rate limit exceeded

---

[API](https://skmtc.dev/multilocale/apis/multilocale-api.md) · [All operations](https://skmtc.dev/multilocale/apis/multilocale-api/llms.txt) · [OpenAPI document](https://skmtc.dev/multilocale/apis/multilocale-api/revisions/9701f774e6c9?raw)