# Update a content item

Updates an existing content item, including its fields and language.

Endpoint: PUT /api/v1/content/{itemId}
Version: v2.0
Security: HTTPBearer

## Security:

  - `HTTPBearer` (unknown)
    http bearer JWT

## Path parameters:

  - `itemId` (string, required)
    The unique identifier of the content item to be updated.

## Header parameters:

  - `x-sc-job-id` (any)
    A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.

## Request fields (application/json):

  - `fields` (any)
    A key-value map of fields to update for the content item. If null, fields will not be updated.

  - `language` (string)
    The language version of the content item to update.
    Example: en

  - `createNewVersion` (boolean)
    Whether to create a new version of the content item.
    Example: false

  - `versionName` (any)
    The name for the new version, displayed beside the version number. This is only applicable if `createNewVersion` is true.
    Example: AEO optimization

  - `siteName` (any)
    The unique name of the site where the content item resides.
    Example: skate-park

## Response 200:

  - `200` (unknown)
    Successful response

## Response 200 fields (application/json):

  - `itemId` (string)
    The unique identifier of the content item.
    Example: 3f2504e0-4f89-11d3-9a0c-0305e82c3301

  - `name` (string)
    The name of the content item.
    Example: Sample Content Item

  - `path` (string)
    The path to the content item.
    Example: /content/items/3f2504e0-4f89-11d3-9a0c-0305e82c3301

  - `updatedFields` (object)
    The fields that were updated in the content item.

  - `language` (any)
    The language version used for the update.
    Example: en

  - `version` (any)
    The item version the update was written to. A new version is created automatically when the item is in a final workflow state, so this may differ from the version you read.
    Example: 3

## Response 422:

  - `422` (unknown)
    Unprocessable entity

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array)
    The location of the error in the request.

  - `detail.msg` (string)
    The error message.

  - `detail.type` (string)
    The type of error.

  - `detail.input` (any)
    The input that caused the error.

  - `detail.ctx` (object)
    The context in which the error occurred.