Update a hierarchy

PUT 
https://euwest.api.elasticpath.com/pcm/hierarchies/:hierarchyID

Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the hierarchy is not updated.

Request

Path Parameters

hierarchyID stringrequired

A unique identifier for the hierarchy.

application/json

Body

required

data objectrequired

id stringrequired

The unique identifier of the hierarchy. Must match the hierarchy ID specified in the request path.

type stringrequired

Possible values: [hierarchy]

This represents the type of resource object being returned. Always hierarchy.

attributes objectrequired

name string

The name of the hierarchy, such as Major Appliances.

description string

A description of the hierarchy.

slug string

A unique slug for the hierarchy.

locales object

Product Experience Manager supports localization of products and hierarchies. If your store supports multiple languages, you can localize product names and descriptions. You can have as many locales as you want.

property name* object

A three-letter language code that represents the name of language you have used.

name string

A localized name for the hierarchy.

description string

A localized description for the hierarchy.

Responses

200

Successfully returns the updated hierarchy

application/json

Schema

Schema

data object

id string

A unique identifier generated when a hierarchy is created.

type string

Possible values: [hierarchy]

This represents the type of resource object being returned. Always hierarchy.

attributes object

name string

The name of a hierarchy, such as Major Appliances.

description string

A description for a hierarchy.

slug string

A unique slug for a hierarchy.

locales object

Product Experience Manager supports localization of hierarchies and nodes. If you store supports multiple languages, you can localize hierarchy and node names and descriptions.

property name* object

A three-letter language code that represents the name of language you have used.

name string

A localized hierarchy or node name.

description string

A localized hierarchy or node description.

relationships object

children object

The child nodes related to the hierarchy.

data array

An array of child nodes.

links object

Links allow you to move between requests.

related string

A link to a related resource.

meta object

created_at date-time

The date and time a hierarchy is created.

updated_at date-time

The date and time a hierarchy is updated.

owner string

Possible values: [store, organization]

The owner of a resource, either organization or store.

Example (from schema)

{
  "data": {
    "id": "string",
    "type": "hierarchy",
    "attributes": {
      "name": "string",
      "description": "string",
      "slug": "string",
      "locales": {}
    },
    "relationships": {
      "children": {
        "data": [
          null
        ],
        "links": {
          "related": "string"
        }
      }
    },
    "meta": {
      "created_at": "2020-09-22T09:00:00",
      "updated_at": "2020-09-22T09:00:00",
      "owner": "store"
    }
  }
}

updated-hierarchy

{
  "data": {
    "type": "hierarchy",
    "id": "6183d10c-94b5-4caa-9f12-2f14cb738d41",
    "attributes": {
      "description": "Shoes Category Updated",
      "locales": {
        "fr-FR": {
          "name": "Chaussures mises à jour",
          "description": "Catégorie de chaussures mise à jour"
        }
      },
      "name": "Shoes Updated",
      "slug": "shoes"
    },
    "relationships": {
      "children": {
        "data": [],
        "links": {
          "related": "/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/children"
        }
      }
    },
    "meta": {
      "created_at": "2024-01-10T20:16:35.343Z",
      "owner": "store",
      "updated_at": "2024-01-10T20:30:50.867Z"
    }
  }
}

403

Forbidden

application/json

Schema

Schema

errors undefined[]required
Array [
status stringrequired
The HTTP response code of the error.
title stringrequired
A brief summary of the error.
detail string
Optional additional detail about the error.
request_id string
Internal request ID.
meta object
Additional supporting meta data for the error.
]

Example (from schema)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

internal-server-error

{
  "errors": [
    {
      "title": "Forbidden",
      "status": "403",
      "detail": "entity owned by organization"
    }
  ]
}

404

Bad Request. Not Found.

application/json

Schema

Schema

errors undefined[]required
Array [
status stringrequired
The HTTP response code of the error.
title stringrequired
A brief summary of the error.
detail string
Optional additional detail about the error.
request_id string
Internal request ID.
meta object
Additional supporting meta data for the error.
]

Example (from schema)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

internal-server-error

{
  "errors": [
    {
      "title": "Not Found",
      "status": "404"
    }
  ]
}

422

Bad request. The request failed validation.

application/json

Schema

Schema

errors undefined[]required
Array [
status stringrequired
The HTTP response code of the error.
title stringrequired
A brief summary of the error.
detail string
Optional additional detail about the error.
request_id string
Internal request ID.
meta object
Additional supporting meta data for the error.
]

Example (from schema)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

failed-validation

{
  "errors": [
    {
      "title": "Failed Validation",
      "status": "422",
      "detail": "<XYZ> can not be empty"
    }
  ]
}

500

Internal server error. There was a system failure in the platform.

application/json

Schema

Schema

errors undefined[]required
Array [
status stringrequired
The HTTP response code of the error.
title stringrequired
A brief summary of the error.
detail string
Optional additional detail about the error.
request_id string
Internal request ID.
meta object
Additional supporting meta data for the error.
]

Example (from schema)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

internal-server-error

{
  "errors": [
    {
      "status": "500",
      "title": "Internal Server Error",
      "detail": "There was an internal server error, you can report with your request id.",
      "request_id": "635da56d-75a1-43cd-b696-7ab119756b3a"
    }
  ]
}

Authorization: http

name: bearerAuthtype: httpscheme: bearer

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X PUT 'https://euwest.api.elasticpath.com/pcm/hierarchies/:hierarchyID' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "type": "hierarchy",
    "attributes": {
      "name": "string",
      "description": "string",
      "slug": "string",
      "locales": {}
    }
  }
}'

Request Collapse all

Base URL

https://euwest.api.elasticpath.com

Auth

Bearer Token

Parameters

hierarchyID — pathrequired

Body required

• Example (from schema)
• update-hierarchy

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "type": "hierarchy",
    "attributes": {
      "name": "string",
      "description": "string",
      "slug": "string",
      "locales": {}
    }
  }
}

ResponseClear

Click the Send API Request button above and see the response here!