---
title: "Update languages of multi-language group"
method: POST
path: "/cms/pages/2026-03/site-pages/multi-language/update-languages"
tags: ["Multi-language"]
---

# Update languages of multi-language group

`POST /cms/pages/2026-03/site-pages/multi-language/update-languages`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/cms/pages/2026-03/site-pages/multi-language/update-languages`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `content`

Explicitly set new languages for each site page in a multi-language group.

## Request body

- UpdateLanguagesRequestVNext
  - `languages` object, required: Map of object IDs to associated languages of object in the multi-language group.
  - `primaryId` string, required: ID of the primary object in the multi-language group.

## Response `default`

An error occurred.

- Error: Represents an error response returned by the API when an operation fails. This component is used in various endpoints to provide detailed information about the error encountered.
  - `category` string, required: The error category
  - `context` object: Context about the error condition
  - `correlationId` string, uuid, required: A unique identifier for the request. Include this value with any error reports or support tickets
  - `errors` ErrorDetail[]: further information about the error
    - `code` string: The status code associated with the error detail
    - `context` object: Context about the error condition
    - `in` string: The name of the field or parameter in which the error was found.
    - `message` string, required: A human readable message describing the error along with remediation steps where appropriate
    - `subCategory` string: A specific category that contains more specific detail about the error
  - `links` object: A map of link names to associated URIs containing documentation about the error or recommended remediation steps
  - `message` string, required: A human readable message describing the error along with remediation steps where appropriate
  - `subCategory` string: A specific category that contains more specific detail about the error

## Changes

- **2026-11-03** (2026-03) `b4815293e3e1`: 1 breaking, 1 info
  - removed the media type `*/*` from the request body
  - added the media type `application/json` to the request body
- **2026-08-27** (2026-03) `c660c62a3f62`: 2 info
  - the security scope `content` was added to the endpoint's security scheme `oauth2`
  - the security scope `content.site_pages.write` was removed from the endpoint's security scheme `oauth2`
- **2026-08-25** (2026-03) `f3f5bc23679e`: 2 info
  - the security scope `content.site_pages.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `content` was removed from the endpoint's security scheme `oauth2`
- **2026-08-17** (2026-03) `32e2d5f3b505`: 2 info
  - the security scope `content.site_pages.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `content` was removed from the endpoint's security scheme `oauth2`
- **2026-05-26** (2026-03) `1e67076d63de`: 48 info
  - added the new `bal` enum value to the request property `languages/additionalProperties/`
  - added the new `bal-pk` enum value to the request property `languages/additionalProperties/`
  - added the new `blo` enum value to the request property `languages/additionalProperties/`
  - added the new `blo-bj` enum value to the request property `languages/additionalProperties/`
  - …44 more

[Operation history](https://skmtc.dev/hubspot/apis/cms-pages/changes/cms/pages/2026-03/site-pages/multi-language/update-languages/post.md)

---

[API](https://skmtc.dev/hubspot/apis/cms-pages.md) - [All operations](https://skmtc.dev/hubspot/apis/cms-pages/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/cms-pages/revisions/b4815293e3e1?raw)