Parent Relationships

Choose the right endpoint

If you are using the Product Content Management services, use the pcm/hierarchies endpoints instead of the v2/categories endpoints. For details about the pcm/hierarchies endpoints, see the topics in the PCM Hierarchies section.

POST Create Parent Category Relationship

https://api.moltin.com/v2/categories/:id/relationships/parent

Create a relationship to a parent category. The new relationship in the request overwrites any existing relationship.

Request

Response

Path Parameters:

Name	Required	Type	Description
id	Required	string	The ID of the category you want to make relationships to.

Headers:

Name	Required	Type	Description
Authorization	Required	string	The Bearer token required to get access to the API.

Body:

Name	Required	Type	Description
type	Required	string	The type of related object. (should be category).
id	Required	string	The ID of the parent category.

204 No Content

cURL

curl -X POST https://api.moltin.com/v2/categories/:id/relationships/parent \
     -H "Authorization: Bearer XXXX" \
     -H "Content-Type: application/json" \
     -d $'{
      "data": {
        "type": "category",
        "id": "8a43aea7-79f0-4bcf-9bc8-a0f5d3d3642c"
      }
    }'

PUT Update Parent Category Relationship

https://api.moltin.com/v2/categories/:id/relationships/parent

Change the parent of a Category.

Request

Response

Path Parameters:

Name	Required	Type	Description
id	Required	string	The ID of the category you want to make relationships to.

Headers:

Name	Required	Type	Description
Authorization	Required	string	The Bearer token required to get access to the API.

Body:

Name	Required	Type	Description
type	Required	string	The type of related object. (should be category).
id	Required	string	The ID of the parent category.

200 OK

cURL

curl -X PUT https://api.moltin.com/v2/categories/:id/relationships/parent \
     -H "Authorization: Bearer XXXX" \
     -H "Content-Type: application/json" \
     -d $'{
      "data": {
        "type": "category",
        "id": "8a43aea7-79f0-4bcf-9bc8-a0f5d3d3642c"
      }
    }'

DELETE Delete Parent Category Relationship

https://api.moltin.com/v2/categories/:id/relationships/parent

Request

Response

Path Parameters:

Name	Required	Type	Description
id	Required	string	The ID of the parent category you with to delete the relationship to.

Headers:

Name	Required	Type	Description
Authorization	Required	string	The Bearer token required to get access to the API.

200 OK

cURL

curl -X DELETE https://api.moltin.com/v2/categories/:id/relationships/parent \
     -H "Authorization: Bearer XXXX"