---
title: "Content items"
slug: "content-items"
abstract: "How to work with content items."
---
# Content items

The content item contains the data, which aligns with the [data model](https://doc.sitecore.com/ch-one/en/developers/content-hub-one/content-management-api/data-model.html#UUID-02356f01-623b-81c7-5313-ab2a9987f7ab_N1710870010115) and is structured according to a content type. You can use query attributes to control the set of items returned. Before you start working with content items, you must [authenticate](https://doc.sitecore.com/ch-one/en/developers/content-hub-one/content-management-api/authentication.md "Authentication").

> [!note]
> The [base URL](https://doc.sitecore.com/ch-one/en/developers/content-hub-one/content-management-api/content-management-api.html "Content Management API") for creating and editing content items is `https://content-api.sitecorecloud.io/`. For guidance on API syntax, see [Syntax](https://doc.sitecore.com/ch-one/en/developers/content-hub-one/content-management-api/syntax.html "Syntax").

> [!note]
> The **CREATE**, **UPDATE**, **DELETE**, **PUBLISH**, and **UNPUBLISH** methods support locales. If you don't include a locale, a *null* locale is assumed.

## Get a list of content items

Use this method to retrieve a list of content items. If you don't specify any [filtering parameters](https://doc.sitecore.com/ch-one/en/developers/content-hub-one/content-management-api/search-and-filter-parameters.html#UUID-01d7a72f-def1-375d-906f-3ef71fdb5351_title-idm273423993491036), you will retrieve all available content items.

```curl
curl --location --request GET  '<BASE_URL>/api/content/v1/items?PageSize=1&PageNumber=1' \
--header 'Accept: text/plain' \
--header 'Authorization: <BEARER_TOKEN>'
```

```json
{
    "totalCount": 19,
    "pageSize": 1,
    "pageNumber": 1,
    "data": [
        {
            "id": "tokg8QTfDECTQoqHeOMnWA",
            "name": "Discover Ireland",
            "fields": {
                "industry": {
                    "value": null,
                    "type": "ShortText"
                },
                "shortDescription": {
                    "value": "Explore the natural beauty and historic importance of Ireland",
                    "type": "LongText"
                },
                "description": {
                    "value": {
                        "type": "doc",
                        "content": [
                            {
                                "type": "paragraph",
                                "content": [
                                    {
                                        "type": "text",
                                        "text": "Ireland is a country known for its stunning natural landscapes and rich history. From rugged coastlines to lush green fields, Ireland offers a diverse range of natural beauty that will leave you in awe. But it's not just the landscapes that make Ireland special; the country is also steeped in history and heritage, with ancient castles, historic sites, and cultural traditions that have been preserved for centuries."
                                    }
                                ]
                            },
                            {
                                "type": "paragraph",
                                "content": [
                                    {
                                        "type": "text",
                                        "text": "One of the most iconic natural landmarks in Ireland is the Cliffs of Moher. Rising dramatically from the Atlantic Ocean, these cliffs offer breathtaking views of the rugged coastline and crashing waves below. The Giant's Causeway, a UNESCO World Heritage site, is another must-visit destination, with its unique hexagonal basalt columns formed by volcanic activity."
                                    }
                                ]
                            },
                            {
                                "type": "paragraph",
                                "content": [
                                    {
                                        "type": "text",
                                        "text": "Ireland is also home to numerous historic sites that tell the story of its past. The ancient passage tomb of Newgrange, built over 5,000 years ago, is older than Stonehenge and the Egyptian pyramids. The Rock of Cashel, a medieval fortress atop a hill, is another iconic landmark that showcases Ireland's rich architectural heritage."
                                    }
                                ]
                            },
                            {
                                "type": "paragraph",
                                "content": [
                                    {
                                        "type": "text",
                                        "text": "Aside from its natural and historic wonders, Ireland is also famous for its vibrant culture and warm hospitality. Traditional Irish music can be heard in pubs across the country, and the lively festivals and events celebrate Irish traditions and customs."
                                    }
                                ]
                            }
                        ]
                    },
                    "type": "RichText"
                },
                "relatedItemsTitle": {
                    "value": null,
                    "type": "ShortText"
                },
                "relatedItemsDescription": {
                    "value": null,
                    "type": "RichText"
                },
                "publishedDate": {
                    "value": null,
                    "type": "DateTime"
                },
                "relatedItems": {
                    "value": [],
                    "type": "Reference"
                },
                "heroImage": {
                    "value": [
                        {
                            "type": "Link",
                            "relatedType": "Media",
                            "id": "K8IHMN2lJEK-j-ZuU_puCA",
                            "uri": "<BASE_URL>/api/content/v1/media/K8IHMN2lJEK-j-ZuU_puCA"
                        }
                    ],
                    "type": "Media"
                }
            },
            "system": {
                "contentType": {
                    "type": "Link",
                    "relatedType": "ContentType",
                    "id": "destination",
                    "uri": "<BASE_URL>/api/content/v1/types/destination"
                },
                "lastPublishProgress": null,
                "locale": "en-US",
                "primary": true,
                "sourceLocale": null,
                "type": "Content",
                "version": "AuW6ifJczxsgU9Mpcl4V0Ydc566ZRbl3GfanYVKqDuQ=",
                "status": "Draft",
                "createdBy": {
                    "type": "Link",
                    "relatedType": "User",
                    "id": "vanessa.m@sitecore.com",
                    "uri": "<BASE_URL>/api/content/v1/users/vanessa.m@sitecore.com"
                },
                "createdAt": "2024-07-02T11:`33:44`.3493014Z",
                "updatedBy": {
                    "type": "Link",
                    "relatedType": "User",
                    "id": "vanessa.m@sitecore.com",
                    "uri": "<BASE_URL>/api/content/v1/users/vanessa.m@sitecore.com"
                },
                "updatedAt": "2024-07-02T11:`33:44`.3493014Z",
                "publishedBy": null,
                "publishedAt": null
            }
        }
    ]
}
```

## Get all references to a content item

Use this method to retrieve a list of all content items that reference a content item with a specific ID and locale. This request uses the `linkedTo` query attribute and retrieves all the items that reference the content item with the ID *mmdvOOpQH0CY4QRLztHflg*.

```curl
curl --location --request GET '<BASE_URL>/api/content/v1/items?linkedTo=mmdvOOpQH0CY4QRLztHflg' \
```

```json
{
    "totalCount": 1,
    "pageSize": 20,
    "pageNumber": 1,
    "data": [
        {
            "id": "tokg8QTfDECTQoqHeOMnWA",
            "name": "Discover Ireland",
            "fields": {
                "industry": {
                    "value": null,
                    "type": "ShortText"
                },
                "shortDescription": {
                    "value": "Explore the natural beauty and historic importance of Ireland",
                    "type": "LongText"
                },
                "description": {
                    "value": {
                        "type": "doc",
                        "content": [
                            {
                                "type": "paragraph",
                                "content": [
                                    {
                                        "type": "text",
                                        "text": "Ireland is a country known for its stunning natural landscapes and rich history. From rugged coastlines to lush green fields, Ireland offers a diverse range of natural beauty that will leave you in awe. But it's not just the landscapes that make Ireland special; the country is also steeped in history and heritage, with ancient castles, historic sites, and cultural traditions that have been preserved for centuries."
                                    }
                                ]
                            },
                            {
                                "type": "paragraph",
                                "content": [
                                    {
                                        "type": "text",
                                        "text": "One of the most iconic natural landmarks in Ireland is the Cliffs of Moher. Rising dramatically from the Atlantic Ocean, these cliffs offer breathtaking views of the rugged coastline and crashing waves below. The Giant's Causeway, a UNESCO World Heritage site, is another must-visit destination, with its unique hexagonal basalt columns formed by volcanic activity."
                                    }
                                ]
                            },
                            {
                                "type": "paragraph",
                                "content": [
                                    {
                                        "type": "text",
                                        "text": "Ireland is also home to numerous historic sites that tell the story of its past. The ancient passage tomb of Newgrange, built over 5,000 years ago, is older than Stonehenge and the Egyptian pyramids. The Rock of Cashel, a medieval fortress atop a hill, is another iconic landmark that showcases Ireland's rich architectural heritage."
                                    }
                                ]
                            },
                            {
                                "type": "paragraph",
                                "content": [
                                    {
                                        "type": "text",
                                        "text": "Aside from its natural and historic wonders, Ireland is also famous for its vibrant culture and warm hospitality. Traditional Irish music can be heard in pubs across the country, and the lively festivals and events celebrate Irish traditions and customs."
                                    }
                                ]
                            }
                        ]
                    },
                    "type": "RichText"
                },
                "relatedItemsTitle": {
                    "value": null,
                    "type": "ShortText"
                },
                "relatedItemsDescription": {
                    "value": null,
                    "type": "RichText"
                },
                "publishedDate": {
                    "value": null,
                    "type": "DateTime"
                },
                "relatedItems": {
                    "value": [
                        {
                            "type": "Link",
                            "relatedType": "Content",
                            "id": "k18AtzkIkkazOB8hw08sZQ",
                            "uri": "<BASE_URL>/api/content/v1/items/k18AtzkIkkazOB8hw08sZQ"
                        },
                        {
                            "type": "Link",
                            "relatedType": "Content",
                            "id": "mmdvOOpQH0CY4QRLztHflg",
                            "uri": "<BASE_URL>/api/content/v1/items/mmdvOOpQH0CY4QRLztHflg"
                        }
                    ],
                    "type": "Reference"
                },
                "heroImage": {
                    "value": [
                        {
                            "type": "Link",
                            "relatedType": "Media",
                            "id": "K8IHMN2lJEK-j-ZuU_puCA",
                            "uri": "<BASE_URL>/api/content/v1/media/K8IHMN2lJEK-j-ZuU_puCA"
                        }
                    ],
                    "type": "Media"
                }
            },
            "system": {
                "contentType": {
                    "type": "Link",
                    "relatedType": "ContentType",
                    "id": "destination",
                    "uri": "<BASE_URL>/api/content/v1/types/destination"
                },
                "lastPublishProgress": null,
                "locale": "fr-CA",
                "primary": false,
                "sourceLocale": "en-US",
                "type": "Content",
                "version": "JAeh7RDFKpmTNIRDYWSDz7asS+Q2xLErOGesa+rBvtE=",
                "status": "Draft",
                "createdBy": {
                    "type": "Link",
                    "relatedType": "User",
                    "id": "vanessa.m@sitecore.com",
                    "uri": "<BASE_URL>/api/content/v1/users/vanessa.m@sitecore.com"
                },
                "createdAt": "2024-07-03T10:`35:11`.1056934Z",
                "updatedBy": {
                    "type": "Link",
                    "relatedType": "User",
                    "id": "vanessa.m@sitecore.com",
                    "uri": "<BASE_URL>/api/content/v1/users/vanessa.m@sitecore.com"
                },
                "updatedAt": "2024-07-03T10:`35:35`.2525468Z",
                "publishedBy": null,
                "publishedAt": null
            }
        }
    ]
}
```

## Other request examples { .notintoc }

You can include query parameters to control the set of items returned as shown in the following examples. You can also exclude all custom fields from the response by appending the query parameter **view=excludeCustomFields**. If you do this, the retrieved list only includes the *NAME*, *CONTENT TYPE*, *UPDATED BY*, *UPDATED ON*, and *STATUS* values for each item.

**Example of an ID query for a single item**

```curl
curl --location '<BASE_URL>/api/content/v1/items/QHuzN24s80i3DVDZXXQOiA' \
--header 'Authorization: <BEARER_TOKEN>'\
--data ''
```

**Example of an ID query for multiple items**

```curl
curl --location '<BASE_URL>/api/content/v1/items?QHuzN24s80i3DVDZXXQOiA%20%7C%20vqST-0YF10uA_3UiUV6owQ=null' \
--header 'Authorization: <BEARER_TOKEN>' \
--data ''
```

**Example of a search query**

```curl
curl --location '<BASE_URL>/api/content/v1/items?search=hotel' \
--header 'Authorization: <BEARER_TOKEN>'
\--data ''
```

**Example of a sortBy query**

```curl
curl --location '<BASE_URL>/api/content/v1/items?sortBy=system.updatedAt' \
--header 'Authorization: <BEARER_TOKEN>'
\--data ''
```

## Get a content item using the ID and locale

Use this method to retrieve a content item with a specific ID and locale. You must include both a content ID and a locale and, for content items with no locale, you must indicate that the locale is *null*. For a list of content item IDs, run the `GET api/content/v1/types` method or open the content item details page. This request returns a content item with the ID `cTgzGGR8wEu1MCgfSqMThw`.

```curl
curl --location --request GET '<BASE_URL>/api/content/v1/items/cTgzGGR8wEu1MCgfSqMThw&locale=sv-SE' \
--header 'Authorization: <BEARER_TOKEN>' \
--data ''
```

```json
{
    "id": "cTgzGGR8wEu1MCgfSqMThw",
    "name": "Luxury Hotel",
    "fields": {
        "industry": {
            "value": "Hospitality",
            "type": "ShortText"
        },
        "shortDescription": {
            "value": "Experience luxury at its finest at our 5-star hotel. Indulge in exquisite cuisine and enjoy a range of sports activities.",
            "type": "LongText"
        },
        "description": {
            "value": {
                "type": "doc",
                "content": [
                    {
                        "type": "paragraph",
                        "content": [
                            {
                                "type": "text",
                                "text": "Welcome to our luxury hotel, where sophistication meets comfort. Our hotel offers a truly exceptional experience with its world-class amenities and impeccable service. Nestled in a picturesque location, our hotel is the perfect destination for a memorable vacation or a lavish getaway."
                            }
                        ]
                    },
                    {
                        "type": "paragraph",
                        "content": [
                            {
                                "type": "text",
                                "text": "Our 5-star cuisine is crafted by renowned chefs who combine culinary expertise with the finest ingredients to create gastronomic masterpieces. Indulge in a delectable array of dishes that will tantalize your taste buds and leave you craving for more."
                            }
                        ]
                    },
                    {
                        "type": "paragraph",
                        "content": [
                            {
                                "type": "text",
                                "text": "For sports enthusiasts, our hotel offers a range of thrilling activities. From tennis and golf to swimming and fitness classes, there is something for everyone. Stay active and energized during your stay with our state-of-the-art sports facilities."
                            }
                        ]
                    },
                    {
                        "type": "paragraph",
                        "content": [
                            {
                                "type": "text",
                                "text": "Pamper yourself with luxurious accommodations, relax in our spa and wellness center, or simply unwind by the poolside. Our dedicated staff is committed to providing personalized service and ensuring that your every need is met."
                            }
                        ]
                    }
                ]
            },
            "type": "RichText"
        },
        "amenities": {
            "value": [],
            "type": "Select"
        },
        "roomType": {
            "value": [],
            "type": "Select"
        },
        "relatedItems": {
            "value": [
                {
                    "type": "Link",
                    "relatedType": "Content",
                    "id": "a-BiLNBsC0eoVmcbbSFnww",
                    "uri": "<BASE_URL>/api/content/v1/items/a-BiLNBsC0eoVmcbbSFnww"
                },
                {
                    "type": "Link",
                    "relatedType": "Content",
                    "id": "k18AtzkIkkazOB8hw08sZQ",
                    "uri": "<BASE_URL>/api/content/v1/items/k18AtzkIkkazOB8hw08sZQ"
                }
            ],
            "type": "Reference"
        },
        "heroImage": {
            "value": [
                {
                    "type": "Link",
                    "relatedType": "Media",
                    "id": "travelLuxuryInn",
                    "uri": "<BASE_URL>/api/content/v1/media/travelLuxuryInn"
                }
            ],
            "type": "Media"
        }
    },
    "system": {
        "contentType": {
            "type": "Link",
            "relatedType": "ContentType",
            "id": "hotels",
            "uri": "<BASE_URL>/api/content/v1/types/hotels"
        },
        "lastPublishProgress": null,
        "locale": "sv-SE",
        "primary": false,
        "sourceLocale": null,
        "type": "Content",
        "version": "OHwno1EJcAGMT8rqTJRb+U+GTP6sifAhoAOq5ALXvC4=",
        "status": "Draft",
        "createdBy": {
            "type": "Link",
            "relatedType": "User",
            "id": "vanessa.m@sitecore.com",
            "uri": "<BASE_URL>/api/content/v1/users/vanessa.m@sitecore.com"
        },
        "createdAt": "2024-03-12T20:`41:31`.9438465Z",
        "updatedBy": {
            "type": "Link",
            "relatedType": "User",
            "id": "vanessa.m@sitecore.com",
            "uri": "<BASE_URL>/api/content/v1/users/vanessa.m@sitecore.com"
        },
        "updatedAt": "2024-07-02T14:`58:19`.5562423Z",
        "publishedBy": null,
        "publishedAt": null
    }
}
```

## Create a content item

Use this method to create a primary content item with a specific ID and locale. This request creates a content item using the *Historical Destinations* content type.

```curl
curl --location --request POST '<BASE_URL>/api/content/v1/items' \
--header 'Content-Type: application/json' \
--header 'Authorization: <BEARER_TOKEN>' \
--data '{
    "id": "princeEdwardcounty",
    "locale": "en-US",
    "contentTypeId": "historicalDestination",
    "name": "Prince Edward County"

}'
```

```json
{
    "id": "princeEdwardcounty",
    "name": "Prince Edward County",
    "fields": {
        "placeName": {
            "value": null,
            "type": "ShortText"
        },
        "description": {
            "value": null,
            "type": "RichText"
        },
        "withTour": {
            "value": null,
            "type": "Boolean"
        },
        "destinationImage": {
            "value": [],
            "type": "Media"
        }
    },
    "system": {
        "contentType": {
            "type": "Link",
            "relatedType": "ContentType",
            "id": "historicalDestination",
            "uri": "<BASE_URL>/api/content/v1/types/historicalDestination"
        },
        "lastPublishProgress": null,
        "locale": null,
        "primary": true,
        "sourceLocale": null,
        "type": "Content",
        "version": "ht38QinnozTdjTtwkAAgJr8kAj4LfJHl+xXd7k8tk/8=",
        "status": "Draft",
        "createdBy": {
            "type": "Link",
            "relatedType": "User",
            "id": "vanessa.m@sitecore.com",
            "uri": "<BASE_URL>/api/content/v1/users/vanessa.m@sitecore.com"
        },
        "createdAt": "2024-07-02T16:`22:03`.8630266Z",
        "updatedBy": {
            "type": "Link",
            "relatedType": "User",
            "id": "vanessa.m@sitecore.com",
            "uri": "<BASE_URL>/api/content/v1/users/vanessa.m@sitecore.com"
        },
        "updatedAt": "2024-07-02T16:`22:03`.8630266Z",
        "publishedBy": null,
        "publishedAt": null
    }
}
```

## Create a localized content item

Use this method to create a [localized content item](https://doc.sitecore.com/ch-one/en/users/content-hub-one/localize-content.html). This request takes the content item with the ID *cTgzGGR8wEu1MCgfSqMThw* and the locale *en-uS* and creates a localized content item with the locale *it-IT*. To use this method, [locales](https://doc.sitecore.com/ch-one/en/developers/content-hub-one/content-management-api/manage-locales-using-the-app.md "Manage locales using the app") must already be defined.

```curl
curl --location --request POST '<BASE_URL>/api/content/v1/items/cTgzGGR8wEu1MCgfSqMThw/copy?locale=it-IT' \
--header 'Content-Type: application/json' \
--header 'Authorization: <BEARER_TOKEN>' \
--data '{
    sourceLocale: "en-US"
}'
```

```json
{
    "id": "cTgzGGR8wEu1MCgfSqMThw",
    "name": "Luxury Hotel",
    "fields": {
        "industry": {
            "value": "Hospitality",
            "type": "ShortText"
        },
        "shortDescription": {
            "value": "Experience luxury at its finest at our 5-star hotel. Indulge in exquisite cuisine and enjoy a range of sports activities.",
            "type": "LongText"
        },
        "description": {
            "value": {
                "type": "doc",
                "content": [
                    {
                        "type": "paragraph",
                        "content": [
                            {
                                "type": "text",
                                "text": "Welcome to our luxury hotel, where sophistication meets comfort. Our hotel offers a truly exceptional experience with its world-class amenities and impeccable service. Nestled in a picturesque location, our hotel is the perfect destination for a memorable vacation or a lavish getaway."
                            }
                        ]
                    },
                    {
                        "type": "paragraph",
                        "content": [
                            {
                                "type": "text",
                                "text": "Our 5-star cuisine is crafted by renowned chefs who combine culinary expertise with the finest ingredients to create gastronomic masterpieces. Indulge in a delectable array of dishes that will tantalize your taste buds and leave you craving for more."
                            }
                        ]
                    },
                    {
                        "type": "paragraph",
                        "content": [
                            {
                                "type": "text",
                                "text": "For sports enthusiasts, our hotel offers a range of thrilling activities. From tennis and golf to swimming and fitness classes, there is something for everyone. Stay active and energized during your stay with our state-of-the-art sports facilities."
                            }
                        ]
                    },
                    {
                        "type": "paragraph",
                        "content": [
                            {
                                "type": "text",
                                "text": "Pamper yourself with luxurious accommodations, relax in our spa and wellness center, or simply unwind by the poolside. Our dedicated staff is committed to providing personalized service and ensuring that your every need is met."
                            }
                        ]
                    }
                ]
            },
            "type": "RichText"
        },
        "relatedItems": {
            "value": [
                {
                    "type": "Link",
                    "relatedType": "Content",
                    "id": "a-BiLNBsC0eoVmcbbSFnww",
                    "uri": "<Base_URL>/api/content/v1/items/a-BiLNBsC0eoVmcbbSFnww"
                },
                {
                    "type": "Link",
                    "relatedType": "Content",
                    "id": "k18AtzkIkkazOB8hw08sZQ",
                    "uri": "<Base_URL>/api/content/v1/items/k18AtzkIkkazOB8hw08sZQ"
                }
            ],
            "type": "Reference"
        },
        "heroImage": {
            "value": [
                {
                    "type": "Link",
                    "relatedType": "Media",
                    "id": "travelLuxuryInn",
                    "uri": "<Base_URL>/api/content/v1/media/travelLuxuryInn"
                }
            ],
            "type": "Media"
        }
    },
    "system": {
        "contentType": {
            "type": "Link",
            "relatedType": "ContentType",
            "id": "hotels",
            "uri": "<Base_URL>/api/content/v1/types/hotels"
        },
        "lastPublishProgress": null,
        "locale": "it-IT",
        "primary": false,
        "sourceLocale": "en-US",
        "type": "Content",
        "version": "OHwno1EJcAGMT8rqTJRb+U+GTP6sifAhoAOq5ALXvC4=",
        "status": "Draft",
        "createdBy": {
            "type": "Link",
            "relatedType": "User",
            "id": "vanessa.m@sitecore.com",
            "uri": "<Base_URL>/api/content/v1/users/vanessa.m@sitecore.com"
        },
        "createdAt": "2024-07-02T17:`06:33`.4455016Z",
        "updatedBy": {
            "type": "Link",
            "relatedType": "User",
            "id": "vanessa.m@sitecore.com",
            "uri": "<Base_URL>/api/content/v1/users/vanessa.m@sitecore.com"
        },
        "updatedAt": "2024-07-02T17:`06:33`.4455016Z",
        "publishedBy": null,
        "publishedAt": null
    }
}
```

## Update a content item

Use this method to update a content item with a specific ID and locale. You can, for example, add or modify content, delete existing content, or change properties associated with the content (such as taxonomy values).

This request updates the description of the content item with the ID *mmdvOOpQH0CY4QRLztHflg* and the locale *en-US* . It also changes the *WithTour* value to *false*.

> [!warning]
> The *Update* method does not merge content; rather, it fully replaces the existing content using the body of the request. For this reason, your request must include the new version of all the content, including your updates and any data you want to retain. Anything not included in your request will be replaced.

```curl
curl --location --request PUT '<BASE_URL>/api/content/v1/items/mmdvOOpQH0CY4QRLztHflg?locale=en-US' \
--header 'Content-Type: application/json' \
--header 'Authorization: <BEARER_TOKEN>' \
--data '{
   "name": "Kilkenny Castle",
   "fields": {
       "placeName": {
           "value": "Kilkenny Castle",
           "type": "ShortText"
       },
       "description": {
           "value": {
               "type": "doc",
               "content": [
                   {
                       "type": "paragraph",
                       "content": [
                           {
                               "type": "text",
                               "text": "Kilkenny Castle in Ireland is a popular tourist attraction and iconic landmark. Built in the 12th century, it started as a defensive stronghold and became a luxurious residence. Inside, visitors can explore elegant drawing rooms, a grand dining hall, and impressive bedrooms. The castle also houses a museum showcasing the region'\''s history. Surrounding the castle are beautiful gardens, parkland, and woodlands, offering a peaceful setting. People visit for the stunning architecture, historical significance, and the vibrant arts scene in Kilkenny. Overall, it'\''s a must-visit for history enthusiasts and architecture lovers to immerse themselves in Ireland'\''s cultural heritage. "
                           }
                       ]
                   }
               ]
           },
           "type": "RichText"
       },
       "withTour": {
           "value": false,
           "type": "Boolean"
       },
       "destinationImage": {
           "value": [],
           "type": "Media"
       }
   },
}'
--data '{
   "id": "eAIfbhsWK0aN2j6g3caMIA",
   "name": "Kilkenny Castle",
   "fields": {
       "placeName": {
           "value": "Kilkenny Castle",
           "type": "ShortText"
       },
       "description": {
           "value": {
               "type": "doc",
               "content": [
                   {
                       "type": "paragraph",
                       "content": [
                           {
                               "type": "text",
                               "text": "Kilkenny Castle in Ireland is a popular tourist attraction and iconic landmark. Built in the 12th century, it started as a defensive stronghold and became a luxurious residence. Inside, visitors can explore elegant drawing rooms, a grand dining hall, and impressive bedrooms. The castle also houses a museum showcasing the region'\''s history. Surrounding the castle are beautiful gardens, parkland, and woodlands, offering a peaceful setting. People visit for the stunning architecture, historical significance, and the vibrant arts scene in Kilkenny. Overall, it'\''s a must-visit for history enthusiasts and architecture lovers to immerse themselves in Ireland'\''s cultural heritage. "
                           }
                       ]
                   }
               ]
           },
           "type": "RichText"
       },
       "withTour": {
           "value": false,
           "type": "Boolean"
       },
       "destinationImage": {
           "value": [],
           "type": "Media"
       }
   },
}'
```

```json
{
    "id": "mmdvOOpQH0CY4QRLztHflg",
    "name": "Kilkenny Castle",
    "fields": {
        "placeName": {
            "value": "Kilkenny Castle",
            "type": "ShortText"
        },
        "description": {
            "value": {
                "type": "doc",
                "content": [
                    {
                        "type": "paragraph",
                        "content": [
                            {
                                "type": "text",
                                "text": "Kilkenny Castle in Ireland is a popular tourist attraction and iconic landmark. Built in the 12th century, it started as a defensive stronghold and became a luxurious residence. Inside, visitors can explore elegant drawing rooms, a grand dining hall, and impressive bedrooms. The castle also houses a museum showcasing the region's history. Surrounding the castle are beautiful gardens, parkland, and woodlands, offering a peaceful setting. People visit for the stunning architecture, historical significance, and the vibrant arts scene in Kilkenny. Overall, it's a must-visit for history enthusiasts and architecture lovers to immerse themselves in Ireland's cultural heritage. "
                            }
                        ]
                    }
                ]
            },
            "type": "RichText"
        },
        "withTour": {
            "value": false,
            "type": "Boolean"
        },
        "destinationImage": {
            "value": [],
            "type": "Media"
        }
    },
    "system": {
        "contentType": {
            "type": "Link",
            "relatedType": "ContentType",
            "id": "historicalDestination",
            "uri": "<BASE_URL>/api/content/v1/types/historicalDestination"
        },
        "lastPublishProgress": null,
        "locale": "en-US",
        "primary": true,
        "sourceLocale": null,
        "type": "Content",
        "version": "W2LbvShlsO5yhOy1QiAXR2IZ66CBwE3kkFMRp/c904A=",
        "status": "Draft",
        "createdBy": {
            "type": "Link",
            "relatedType": "User",
            "id": "vanessa.m@sitecore.com",
            "uri": "<Base_URL>/api/content/v1/users/vanessa.m@sitecore.com"
        },
        "createdAt": "2024-05-01T13:`18:45`.9980882Z",
        "updatedBy": {
            "type": "Link",
            "relatedType": "User",
            "id": "vanessa.m.com",
            "uri": "<Base_URL>/api/content/v1/users/vanessa.m@sitecore.com"
        },
        "updatedAt": "2024-07-02T17:`59:52`.630194Z",
        "publishedBy": null,
        "publishedAt": null
    }
}
```

## Delete a content item

Use this method to delete a content item with a specific ID and locale. If the content item is published, you must unpublish it first. You cannot delete a primary content item if it has associated localizations. This request deletes a content item with the ID *eI_95LOp7UG4nC8rScISnQ* and a locale of *fr-CA*

```curl
curl --location --request DELETE '<BASE_URL>/api/content/v1/items/eI_95LOp7UG4nC8rScISnQ?locale=fr-CA' \
--header 'Authorization: <BEARER_TOKEN>'
```

## Publish a content item

Use this method to publish a content item with a specific ID and locale. This request publishes a content item with the ID *\-mmdvOOpQH0CY4QRLztHflg* and the locale *fr-FR*.

```curl
curl --location --request POST '<BASE_URL>/api/content/v1/items/-mmdvOOpQH0CY4QRLztHflg/publish?locale=fr-FR' \
--header 'Accept: text/plain' \
--header 'Authorization: <BEARER_TOKEN>'
```

## Unpublish a content item

Use this method to unpublish a content item with a specific ID and locale. This request publishes a content item with the ID *Mifoxjxc60SWt-8ntpDxeA* and locale *fr-CA*.

```curl
curl --location --request DELETE '<BASE_URL>/api/content/v1/items/Mifoxjxc60SWt-8ntpDxeA/publish?locale=fr-CA'
 \--header 'Accept: text/plain' \
--header 'Authorization: <BEARER_TOKEN>'
```