Update a locale

PUT

https://api.contentful.com/spaces/:space_id/environments/:environment_id/locales/:locale_id

PUT

/spaces/:space_id/environments/:environment_id/locales/:locale_id

$ curl -X PUT https://api.contentful.com/spaces/yadj1kx9rmg0/environments/staging/locales/0xpIUSHPfJRzsAFFaub3hT \
>      -H "X-Contentful-Version: 3" \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/vnd.contentful.management.v1+json" \
>      -d '{
>   "name": "English (United States)",
>   "code": "en-US",
>   "fallbackCode": "en-US",
>   "optional": false
> }'

201Locales_updateALocale_example

1 {
2   "name": "English (United States)",
3   "code": "en-US",
4   "fallbackCode": "en-US",
5   "contentDeliveryApi": true,
6   "contentManagementApi": true,
7   "default": false,
8   "optional": false,
9   "sys": {
10     "type": "Locale",
11     "id": "34N35DoyUQAtaKwWTgZs34",
12     "version": 1,
13     "space": {
14       "sys": {
15         "type": "Link",
16         "linkType": "Space",
17         "id": "yadj1kx9rmg0"
18       }
19     },
20     "environment": {
21       "sys": {
22         "type": "Link",
23         "linkType": "Environment",
24         "id": "staging"
25       }
26     },
27     "createdAt": "2025-07-13T03:17:24.000Z",
28     "createdBy": {
29       "sys": {
30         "type": "Link",
31         "linkType": "User",
32         "id": "7BslKh9TdKGOK41VmLDjFZ"
33       }
34     },
35     "updatedAt": "2025-07-13T03:17:24.000Z",
36     "updatedBy": {
37       "sys": {
38         "type": "Link",
39         "linkType": "User",
40         "id": "4FLrUHftHW3v2BLi9fzfjU"
41       }
42     }
43   }
44 }

Updates a locale in a space; include the current version in X-Contentful-Version. Changing a locale’s code affects all future API responses and is not allowed on locales used as fallbacks.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

space_idstringRequired

ID of the Space in form of a string

environment_idstringRequired

ID of the environment in form of a string

locale_idstringRequired

ID of the Locale in form of a string

Headers

X-Contentful-VersionstringRequired

Version of the locale to update

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

Created - Resource created successfully