Get Releases

Gets all authorized catalog releases

GET/catalogs/{catalog_id}/releases

Use it in a workflow

Add a step and choose the Elastic Path connector.
Pick the Get Releases action (under Catalog).
Fill in the fields below, then reference the result from later steps as {{getReleases.response.data}}.

Request

Path parameters

catalog_idstringrequired

The catalog ID.

Headers

accept-languagestring

The language and locale your storefront prefers. See [Accept-Language](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language).

Response

Returns 200 with an object. Read it in later steps with {{getReleases.response.data.<field>}}.

dataarray<object>

idstring

A unique identifier for the catalog release.

attributesobject5 fields

relationshipsobject3 fields

Relationships are established between different catalog entities. For example, products, hierarchies, price books, and catalog rules are related to a catalog, as they are associated with it.

typestring

This represents the type of object being returned. Always `catalog-release`.

metaobject13 fields

A release's metadata.

linksobject

Links allow you to move between requests.

selfstring (uri)

Single entities use a `self` parameter with a link the specific resource.

firststring (uri)

Always the first page.

laststring (uri)

This is `null` if there is only one page.

prevstring (uri)

This is `null` if there is only one page.

nextstring (uri)

This is `null` if there is only one page.

json

{
  "data": [
    {
      "id": "8dbb35b2-ef04-477e-974d-e5f3abe6faae",
      "attributes": {
        "name": "Clothing",
        "published_at": "1970-01-01T00:00:00.000",
        "catalog_id": "0194f54d-f2a1-4e33-9a6e-9ec366152490",
        "description": "Catalog for Store 123",
        "hierarchies": [
          {
            "id": "65477ce0-fcb8-436b-a120-3d57979421dd",
            "label": "category",
            "name": "Formal dresswear"
          }
        ]
      },
      "relationships": {
        "delta": {
          "links": {
            "related": "string"
          }
        },
        "products": {
          "links": {
            "related": "string"
          }
        },
        "hierarchies": {
          "links": {
            "related": "string"
          }
        }
      },
      "type": "string",
      "meta": {
        "created_at": "1970-01-01T00:00:00.000",
        "started_at": "1970-01-01T00:00:00.000",
        "updated_at": "1970-01-01T00:00:00.000",
        "release_status": "PENDING",
        "language": "en-GB",
        "is_full_publish": false,
        "is_full_delta": false,
        "total_products": 0,
        "total_nodes": 0,
        "percent_completed": 0,
        "owner": "store",
        "price_segmentation_enabled": false
      }
    }
  ],
  "links": {
    "self": "string",
    "first": "string",
    "last": "string",
    "prev": "string",
    "next": "string"
  }
}

Need more? See the Elastic Path guide for connection setup and behaviour shared by every action.

Was this page helpful?