Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Elastic Path Product Relationships API

The Product Relationships API from Elastic Path — 3 operation(s) for product relationships.

Elastic Path Product Relationships API is one of 100 APIs that Elastic Path publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Product Relationships. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 7 operations across 3 paths, and defines 22 schemas. It is described by OpenAPI 3.1.0, at version 25.1126.6886238.

Requests are made against 2 base URLs: https://useast.api.elasticpath.com, https://euwest.api.elasticpath.com.

7 operations 3 paths 22 schemas 2 DELETE3 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
25.1126.6886238
Base URL
https://useast.api.elasticpath.com
Authentication
HTTP Bearer
License
Resource Areas
1

Authentication & Security 1

Elastic Path Product Relationships API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerToken). By default, every request must be authenticated.

Paths & Operations 7

Across 3 paths, the API surfaces 7 operations — 2 DELETE, 3 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Product Relationships 7
POST
/pcm/products/{productID}/custom-relationships
Attach Custom Relationships to a Product
attachCustomRelationships 1 param body → 201400403404409422500
DELETE
/pcm/products/{productID}/custom-relationships
Delete Custom Relationships from a Product
detachCustomRelationships 1 param body → 204400403404409422500
GET
/pcm/products/{productID}/custom-relationships
Get all Custom Relationships attached to a Product
listAttachedCustomRelationship 3 params body → 200400403404409422500
POST
/pcm/products/{productID}/custom-relationships/{customRelationshipSlug}
Create a Relationship between a Product with one or more Products
productAssociationId 2 params body → 201400403404409422500
DELETE
/pcm/products/{productID}/custom-relationships/{customRelationshipSlug}
Delete a Relationship between a product with one or more products
dissociateProducts 2 params body → 204400403404409422500
GET
/pcm/products/{productID}/custom-relationships/{customRelationshipSlug}
Get all Related Product IDs of a Products' attached Custom Relationship
getRelatedProductIDsOfAProductId 4 params → 200400403404409422500
GET
/pcm/products/{productID}/custom-relationships/{customRelationshipSlug}/products
Get all Related Products of a Products' attached Custom Relationship
getRelatedProductsOfAProductId 4 params → 200400403404422500

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are elastic_path_file (9 properties), req_attributes_custom_relationship (7 properties), product_response (5 properties), multi_links (5 properties). Each schema is shown below with its type and property counts.

product_association_delete_request
object
1 property 1 required
multi_links_cr
object
Links are used to allow you to move between requests.
4 properties
product_build_rules
object
You can build a combination of child products associated with a product, based on build rules that you specify. This is useful, for example, if you have a vari…
3 properties
custom_relationship
object
4 properties 4 required
error
object
1 property 1 required
product_association_response
object
1 property
req_attributes_custom_relationship
object
7 properties 2 required
attach_custom_relationship_request
object
1 property 1 required
multi_meta
object
1 property
admin_attributes
object
adminattributes are not displayed in catalogs. This means adminattributes can only be viewed by administrators. If you want a custom attribute to be displayed…
elastic_path_file
object
9 properties
multi_links
object
Links allow you to navigate between pages of results. :::caution Planned pagination changes — on or after 1 September 2026 The pagination behaviour of PIM list…
5 properties
multi_product_response
object
4 properties
shopper_attributes
object
shopperattributes are displayed in catalogs. This means shopperattributes can be viewed by both shoppers and administrators. If you do not want a custom attrib…
included_response
object
Included is an array of resources that are included in the response.
3 properties
product_association_list_product_ids_response
object
1 property 1 required
multi_custom_relationships
object
3 properties 2 required
product_locales
object
Product Experience Manager supports localization of products and hierarchies. If your store supports multiple languages, you can localize product names and des…
product_association_request
object
1 property 1 required
product_response
object
5 properties
product_bundle_components
object
With Product Experience Manager, you can create and manage bundles. A bundle is a purchasable product, consisting of one or more products that you want to sell…
product_custom_inputs
object
You use the custominputs attribute to allow your shoppers to add custom text to a product when adding product items to their carts. This is useful, for example…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

elastic-path-product-relationships-api-openapi.yml Raw ↑

Other APIs Elastic Path publishes across the network.

Elastic Path GraphQL API
Elastic Path Account Addresses API
Elastic Path Account Authentication Settings API
Elastic Path Account Cart Associations API
Elastic Path Account Management Authentication API
Elastic Path Account Members API
Elastic Path Account Membership API
Elastic Path Account Membership Settings API
Elastic Path Account Tags API
Elastic Path Accounts API
Elastic Path Administrator Latest Releases Catalog API API
Elastic Path Application Keys API