Update a content item

Request

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

Security

HTTPBearer

Path

itemIdstring, (uuid)(Itemid)required

The unique identifier of the content item to be updated.

Example:3f2504e0-4f89-11d3-9a0c-0305e82c3301

Headers

x-sc-job-idany(X-Sc-Job-Id)

A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.

Example:job-1234

Bodyapplication/jsonrequired

fieldsobject or null(Fields)

Any of:

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

languagestring(Language)

The language version of the content item to update.

Default:"en"

Example:"en"

createNewVersionboolean(Createnewversion)

Whether to create a new version of the content item.

Default:false

Example:false

versionNamestring or null(Versionname)

Example:"AEO optimization"

Any of:

The name for the new version, displayed beside the version number. This is only applicable if createNewVersion is true.

string

siteNamestring or null(Sitename)

Example:"skate-park"

Any of:

The unique name of the site where the content item resides.

string

curl -i -X PUT \
  https://edge-platform.sitecorecloud.io/stream/ai-agent-api/api/v1/content/3f2504e0-4f89-11d3-9a0c-0305e82c3301 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'x-sc-job-id: job-1234' \
  -d '{
    "fields": {},
    "language": "en",
    "createNewVersion": false,
    "versionName": "AEO optimization",
    "siteName": "skate-park"
  }'

Responses

Successful response

Bodyapplication/json

itemIdstring, (uuid)(Itemid)

The unique identifier of the content item.

Example:"3f2504e0-4f89-11d3-9a0c-0305e82c3301"

namestring(Name)

The name of the content item.

Example:"Sample Content Item"

pathstring(Path)

The path to the content item.

Example:"/content/items/3f2504e0-4f89-11d3-9a0c-0305e82c3301"

updatedFieldsobject(Updatedfields)

The fields that were updated in the content item.

languagestring or null(Language)

Example:"en"

Any of:

The language version used for the update.

string

versioninteger or null(Version)

Example:3

Any of:

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.

integer

Response

{
  "itemId": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
  "name": "Sample Content Item",
  "path": "/content/items/3f2504e0-4f89-11d3-9a0c-0305e82c3301",
  "updatedFields": {},
  "language": "en",
  "version": 3
}