---
title: "Update a job target locale"
method: PATCH
path: "/projects/{project_id}/jobs/{job_id}/locales/{id}"
tags: ["Job Locales"]
---

# Update a job target locale

`PATCH /projects/{project_id}/jobs/{job_id}/locales/{id}`

Update an existing job target locale.

## Path parameters

- `project_id` string, required
- `job_id` string, required
- `id` string, required

## Headers

- `X-PhraseApp-OTP` string

## Request body

- object
  - `branch` string — specify the branch to use
  - `locale_id` string — ID of a target locale to update
  - `user_ids` string[] — Array of user ids to be assigned to the job locale
  - `reviewer_ids` string[] — Array of reviewer ids to be assigned to the job locale as reviewers
  - `translator_team_ids` string[] — Array of team ids to be assigned to the job locale as translators
  - `reviewer_team_ids` string[] — Array of team ids to be assigned to the job locale as reviewers

## Response `200`

OK

- JobLocale
  - `id` string
  - `job` JobPreview
    - `id` string
    - `name` string
    - `state` string
  - `locale` LocalePreview
    - `id` string
    - `name` string
    - `code` string
  - `users` LocaleUserPreview[]
    - `id` string
    - `username` string
    - `name` string
    - `role` string
  - `teams` LocaleTeamPreview[]
    - `id` string
    - `name` string
    - `role` string
  - `completed` boolean
  - `translation_completed_at` string, date-time
  - `review_completed_at` string, date-time
  - `annotations` JobAnnotationShort[]
    - `name` string, required
    - `value` string, required

## Other responses

- `400` — Bad request. The request could not be parsed or a parameter failed validation. Verify the request body, the content type, and the parameter types, then retry.
- `404` — Not found. The requested resource does not exist or is not visible to the authenticated user. Verify the identifiers in the request path and that the token has access to them, then retry.
- `429` — Too many requests. The rate limit has been exceeded. Wait until the time indicated by the `X-Rate-Limit-Reset` response header before retrying.

---

[API](https://skmtc.net/phrase/apis/control-hub-service.md) · [All operations](https://skmtc.net/phrase/apis/control-hub-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phrase/control-hub-service/revisions/98ecac7ba2bf/schema)