Update a Catalog object

You can update part of a Catalog object by including its ID in the path of a PATCH request. This document covers the two methods for performing PATCH operations on Catalog objects:

  • Using fields
  • Using JSON Patch notation
NOTE
PATCH operations on an object cannot modify its expandable fields, which represent interrelated objects. Modifications to interrelated objects must be made directly.

Update using fields

The following example call demonstrates how to update an object using fields and values.

API format

PATCH /{OBJECT_TYPE}/{OBJECT_ID}
Parameter
Description
{OBJECT_TYPE}

The type of Catalog object to be updated. Valid objects are:

  • batches
  • dataSets
  • dataSetFiles
{OBJECT_ID}
The identifier of the specific object you want to update.

Request

The following request updates the name and description fields of a dataset to the values provided in the payload. Object fields that are not to be updated can be excluded from the payload.

curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
       "name":"Updated Dataset Name",
       "description":"Updated description for Sample Dataset"
      }'

Response

A successful response returns an array containing ID of the updated dataset. This ID should match the one sent in the PATCH request. Performing a GET request for this dataset now shows that only the name and description have been updated while all other values remain unchanged.

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]

Update using JSON Patch notation

The following example call demonstrates how to update an object using JSON Patch, as outlined in RFC-6902.

For more information on JSON Patch syntax, see the API fundamentals guide.

API format

PATCH /{OBJECT_TYPE}/{OBJECT_ID}
Parameter
Description
{OBJECT_TYPE}

The type of Catalog object to be updated. Valid objects are:

  • batches
  • dataSets
  • dataSetFiles
{OBJECT_ID}
The identifier of the specific object you want to update.

Request

The following request updates the name and description fields of a dataset to the values provided in each JSON Patch object. When using JSON Patch, you must also set the Content-Type header to application/json-patch+json.

curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json-patch+json' \
  -d '[
        { "op": "add", "path": "/name", "value": "New Dataset Name" },
        { "op": "add", "path": "/description", "value": "New description for dataset" }
      ]'

Response

A successful response returns an array containing the ID of the updated object. This ID should match the one sent in the PATCH request. Performing a GET request for this object now shows that only the name and description have been updated while all other values remain unchanged.

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676