Sitecore API catalog/Agent API/Content

Content

The Content API lets you create, retrieve, update, delete and organize structured content items, and retrieve insert options.

Operations

Create content item

Request

Creates a new content item using the specified template and field values.

Security
HTTPBearer
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
templateIdstring, (uuid)(Templateid)required

The unique identifier of the template used to create the content item.

Example:"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"
namestring(Name)required

The name of the content item to create.

Example:"New Promo"
parentIdstring, (uuid)(Parentid)required

The unique identifier of the parent item.

Example:"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"
languagestring(Language)

The language code for the content item.

Default:"en"
Example:"en"
fieldsobject or null(Fields)
Any of:

A key-value map of field names and their values for the content item, or null if none.

curl -i -X POST \
  https://edge-platform.sitecorecloud.io/stream/ai-agent-api/api/v1/content/create \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'x-sc-job-id: job-1234' \
  -d '{
    "templateId": "9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f",
    "name": "New Promo",
    "parentId": "9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f",
    "language": "en",
    "fields": {}
  }'

Responses

Successful response

Bodyapplication/json
itemIdstring, (uuid)(Itemid)

The unique identifier of the created content item.

Example:"3f2504e0-4f89-11d3-9a0c-0305e82c3301"
namestring(Name)

The name of the created content item.

Example:"New Promo"
pathstring(Path)

The path of the created content item.

Example:"/sitecore/layout/Renderings/Feature/JSS Experience Accelerator/Page Content/Promo/New Promo"
templateIdstring, (uuid)(Templateid)

The unique identifier of the template used for the content item.

Example:"9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f"
versioninteger(Version)

The version number of the created content item.

Example:1
Response
{
  "itemId": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
  "name": "New Promo",
  "path": "/sitecore/layout/Renderings/Feature/JSS Experience Accelerator/Page Content/Promo/New Promo",
  "templateId": "9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f",
  "version": 1
}