Skip to contentDevelopersPrezly website
Newsroom languages

Deactivate Newsroom Language

Disable a locale, supplying a replacement when required.

Personal token scopes: sites:write. Your account must also have access to the requested data. Authentication

The only enabled locale cannot be removed. Removing the default or a locale with stories requires a different replacement; stories move to that code rather than being translated.

Read the guide

DELETE
/newsrooms/{newsroom_id}/languages/{locale}

Note: replacement payload parameter is required when:

  • When the language being deactivated is the newsroom default language. The given replacement locale code will become the new default language.
  • When the language being deactivated has stories attached. All the stories will be moved to the given replacement locale.

The only remaining language cannot be removed. A replacement must differ from the removed locale. Replacing a default changes the default; linked stories move to the replacement locale. This does not copy company information as a code migration does.

Personal access tokens: sites:write. Every listed scope is required; the token owner's permissions, feature availability and newsroom access still apply.

Authorization

API_key
headerAuthorizationBearer <token>

Bearer authentication using an integration API key, or a personal access token only where the operation explicitly supports it. Every listed personal-token scope is required; owner permissions and newsroom access still apply.

Path Parameters

newsroom_id*string

Newsroom UUID or ID

Length1 <= length
locale*string

Language code (ISO 639-1 or ISO 639-2), with optional script designator (ISO 15924) and optional region code (ISO 3166-1).

Length2 <= length

Request Body

application/json
  1. body
replacement?LocaleCode

Language code (ISO 639-1 or ISO 639-2), with optional script designator (ISO 15924) and optional region code (ISO 3166-1).

Match[a-z]{2,3}(_[A-Z][a-z]{3})?(_[A-Z]{2})?
Length2 <= length

Response Body

No Content

Example Request
curl -X DELETE 'https://api.prezly.com/v2/newsrooms/string/languages/nl_BE' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
Empty