Create a content item version

Request

Creates a new version of the specified content item in the specified language by copying values from a source version. If baseVersion is omitted, the latest version is used as the source.

Security

Bearer

Path

idstringrequired

The content item identifier.

Example:E591251E-C34B-4DF4-9DC1-CA0C27587F90

Query

environmentIdstring

The environment identifier. Defaults to "main".

Example:environmentId=main

Body

required

Input for creating a new content item version.

languagestring, non-emptyrequired

Language of the content item version to create.

Example:"en"

baseVersioninteger or null, (int32)

Source version to copy field values from. If omitted, the latest version is used.

Example:1

versionNamestring or null

Optional user-defined version label.

Example:"Autumn campaign"

curl -i -X POST \
  'https://edge-platform.sitecorecloud.io/authoring/api/v1/content-items/E591251E-C34B-4DF4-9DC1-CA0C27587F90/versions?environmentId=main' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "language": "en",
    "baseVersion": 1,
    "versionName": "Autumn campaign"
  }'

Responses

Successful operation

Bodyapplication/json

idstring or null

The content item identifier, unchanged across versions.

Example:"3875AC96-8ECF-44AE-8E25-851068B373CE"

languagestring or null

Language associated with this version.

Example:"en"

versioninteger, (int32)

Backend-assigned version number.

Example:3

versionNamestring or null

User-defined version label.

Example:"Autumn campaign"

revisionstring or null

Revision for this version.

Example:"37265ed7-85cf-4876-9c09-b6590fc6cf3a"

systemobject(System)

permissionsobject(Permissions)

The access rights of the current user to the site.

Response

{
  "id": "3875AC96-8ECF-44AE-8E25-851068B373CE",
  "language": "en",
  "version": 3,
  "versionName": "Autumn campaign",
  "revision": "37265ed7-85cf-4876-9c09-b6590fc6cf3a",
  "system": {
    "created": "2024-01-15T10:30:00Z",
    "createdBy": "sitecore admin",
    "updated": "2024-01-15T10:30:00Z",
    "updatedBy": "sitecore admin"
  },
  "permissions": {
    "canAdmin": true,
    "canWrite": true,
    "canCreate": true,
    "canDelete": true,
    "canRename": true,
    "canRead": true,
    "canPublish": true,
    "canDuplicate": true,
    "canWriteLanguage": true
  }
}