Create a content item

Request

Creates a new content item under the specified parent, which is also a content item. Content items are instances of a content type (specified in this call by templateId)

Security

Bearer

Query

environmentIdstring

The environment identifier.

Example:environmentId=main

Body

required

The creation input.

namestring, non-emptyrequired

The content item name.

Example:"MyContentItem"

parentIdstring, non-emptyrequired

The identifier of the content item that is the parent of the new content item.

Example:"{110D559F-DEA5-42EA-9C1C-8A5DF7E70EF9}"

templateIdstring, non-emptyrequired

The content type identifier.

Example:"{76036F5E-CBCE-46D1-AF0A-4143F9B557AA}"

displayNamestring or null

The content item display name.

Example:"My Content Item"

languagestring or null

The content item language.

Example:"en"

fieldsArray of objects or null(UpdateFieldValue)

The content item field values. Each field's Id must match a field defined on the TemplateId and can be found by calling the Retrieve a Content Type endpoint in the Content Types API. When null or empty, the item is created with no field values.

curl -i -X POST \
  'https://edge-platform.sitecorecloud.io/authoring/api/v1/content-items?environmentId=main' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "MyContentItem",
    "displayName": "My Content Item",
    "parentId": "{110D559F-DEA5-42EA-9C1C-8A5DF7E70EF9}",
    "templateId": "{76036F5E-CBCE-46D1-AF0A-4143F9B557AA}",
    "language": "en",
    "fields": [
      {
        "id": "75577384-3C97-45DA-A847-81B00500E25",
        "value": {
          "title": "sample title"
        }
      }
    ]
  }'

Responses

Successful operation

Bodyapplication/json

isFallbackboolean

Indicates whether any item-level fallback was used for the response.

Example:true

revisionstring or null

Unique revision identifier for the content item. Used as an optimistic concurrency guard during save or update operations. The value is updated whenever the item changes, allowing clients to verify that they are updating the latest revision.

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

fieldsArray of objects or null(ComponentItemField)

The content item fields.

idstring or null

The content item identifier.

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

namestring or null

The content item name.

Example:"My content item"

displayNamestring or null

The content item display name.

Example:"My content item"

languagestring or null

The content item language.

Example:"en"

versioninteger, (int32)

The content item version.

Example:1

templateIdstring or null

The template identifier.

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

pathstring or null

The content item path.

Example:"/sitecore/content/Home"

permissionsobject(Permissions)

The access rights of the current user to the site.

systemobject(System)

Response

{
  "isFallback": true,
  "revision": "37265ed7-85cf-4876-9c09-b6590fc6cf3a",
  "fields": [
    { … }
  ],
  "id": "37265ed7-85cf-4876-9c09-b6590fc6cf3a",
  "name": "My content item",
  "displayName": "My content item",
  "language": "en",
  "version": 1,
  "templateId": "97265ed7-85cf-4876-9c09-b6590fc6cf3a",
  "path": "/sitecore/content/Home",
  "permissions": {
    "canAdmin": true,
    "canWrite": true,
    "canCreate": true,
    "canDelete": true,
    "canRename": true,
    "canRead": true,
    "canPublish": true,
    "canDuplicate": true,
    "canWriteLanguage": true
  },
  "system": {
    "created": "2024-01-15T10:30:00Z",
    "createdBy": "sitecore admin",
    "updated": "2024-01-15T10:30:00Z",
    "updatedBy": "sitecore admin"
  }
}