Skip to contentDevelopersPrezly website
Newsroom languages

Add Newsroom Language

Enable a locale and save its company information.

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

Returns 200 with a language envelope. Adding another configured locale requires multilingual newsroom access; is_default accepts only true.

Read the guide

PUT
/newsrooms/{newsroom_id}/languages/{locale}

Enable the given language for a newsroom.

If the language was already enabled, it will be updated, according to the request paylaod.

This enables or updates the language. Company information uses partial updates. Adding a further language can require the multilingual-newsrooms feature. To migrate an existing language and its stories, use PATCH with code.

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
is_default?boolean

This can only be set to true.

company_information?

Payload to update Newsroom Company Information

Response Body

OK

application/json
  1. response
language*
Example Request
curl -X PUT 'https://api.prezly.com/v2/newsrooms/string/languages/nl_BE' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "language": {    "code": "en",    "locale": {      "code": "en",      "name": "string",      "direction": "ltr",      "language_code": "en",      "native_name": "string"    },    "is_default": true,    "stories_count": 0,    "categories_count": 0,    "company_information": {      "name": "string",      "about": "string",      "email": "user@example.com",      "website": "http://example.com",      "phone": "string",      "address": "string",      "twitter": "string",      "facebook": "string",      "linkedin": "string",      "pinterest": "string",      "youtube": "string",      "instagram": "string",      "tiktok": "string",      "discord": "string",      "skype": "string",      "snapchat": "string",      "twitch": "string",      "email_disclaimer": "string",      "cookie_statement": "string",      "subscribe_disclaimer": "string"    },    "public_stories_count": 0,    "default_email_disclaimer": "string",    "default_cookie_statement": "string",    "default_subscribe_disclaimer": "string"  }}