---
title: "Update contentlet styles in a page"
method: PUT
path: "/api/v1/page/{pageId}/styles"
tags: ["Page"]
---

# Update contentlet styles in a page

`PUT /api/v1/page/{pageId}/styles`

## Request

- Base URL: `https://docs.anzworldline-solutions.com.au`
- URL: `https://docs.anzworldline-solutions.com.au/api/v1/page/{pageId}/styles`
- Auth: none declared
- TypeScript: <https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/docs/api/v1/page/:pageId/styles/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates style properties for contentlets within containers on a specific page. Only updates the styleProperties field without modifying page structure.

## Path parameters

- `pageId` string, required

## Request body

- ContentWithStylesForm: Container with contentlet style properties
  - `identifier` string, required: Container identifier
  - `uuid` string, required: Container unique identifier (UUID)
  - `personaTag` string: Raw Persona key tag (e.g. the value of viewAs.persona.keyTag) to personalize this style update for. Do not include the 'dot:persona:' prefix -- the backend adds it automatically. Omit for the default persona.

## Response `200`

Contentlet styles updated successfully

- ResponseEntityContentView
  - `errors` ErrorEntity[]
    - `errorCode` string
    - `message` string
    - `fieldName` string
  - `entity` ContentView[]
    - `containerId` string, required: Container identifier
    - `uuid` string, required: Container unique identifier (UUID)
    - `contentletId` string, required: Contentlet identifier
    - `dotStyleProperties` object: Styles defined for the Contentlet
      - `empty` boolean
  - `messages` MessageEntity[]
    - `message` string
  - `i18nMessagesMap` object
  - `permissions` string[]
  - `pagination` Pagination
    - `currentPage` integer
    - `perPage` integer
    - `totalEntries` integer

## Other responses

- `400`: Invalid request - empty container entries or invalid contentlet references
- `401`: Unauthorized - authentication required
- `403`: Forbidden - user does not have EDIT permission on the page
- `404`: Page not found

## Changes

- **2026-10-30** `4fd8e917d458`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/changes/api/v1/page/:pageId/styles/put.md)

---

[API](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api.md) - [All operations](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anzworldline-solutions/apis/dotcms-rest-api/revisions/4fd8e917d458?raw)