Catalog management

Manage catalogs

Creating a catalog

post

Creates a new catalog based on the provided request payload, for the specified tenant.

---

Required scopes

catalog.catalog_manage

Authorizations

Path parameters

tenantstringRequired

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Example: saasdev2

Body

Payload for creating a new catalog

idstring · min: 1 · max: 66Optional

Custom catalog identifier. If not provided, it is automatically generated.

Pattern: ^[a-zA-Z0-9_-]$

nameall ofRequired

one ofOptional

Name of the catalog must be a string if the Content-Language header is set or a map of translations if the header is missing.

stringOptional

or

and

anyOptional

Name of the catalog must be a string if the Content-Language header is set or a map of translations if the header is missing.

descriptionall ofOptional

one ofOptional

Name of the catalog must be a string if the Content-Language header is set or a map of translations if the header is missing.

stringOptional

or

and

anyOptional

Description of the catalog must be a string if the Content-Language header is set or a map of translations if the header is missing.

publishedSitesstring[]Optional

List of site identifiers on which the catalog is published.

categoryIdsstring[]Optional

List of root category identifiers that are assigned to the catalog.

Responses

201

The catalog has been successfully created.

application/json

400

Request was syntactically incorrect. Details will be provided in the response payload.

application/json

403

Permission denied due to insufficient rights.

application/json

409

Given resource already exists.

application/json

500

An unexpected error prevented the server from fulfilling the request.

application/json

post

HTTPcURLJavaScriptPython

POST /catalog/{tenant}/catalogs HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 241

{
  "name": {
    "en": "This is a catalog"
  },
  "description": {
    "en": "This catalog is used as an example"
  },
  "visibility": {
    "visible": true,
    "from": "2022-02-24T20:44:43.169Z",
    "to": "2023-07-24T20:44:43.169Z"
  },
  "publishedSites": [
    "Main"
  ],
  "categoryIds": [
    "3249485"
  ]
}

{
  "id": "text"
}

Upserting a catalog

put

Update or create the specified catalog.

---

Required scopes

catalog.catalog_manage

Authorizations

Path parameters

tenantstringRequired

Your Emporix tenant's name. Note: The tenant should always be written in lowercase.

Example: saasdev2

catalogIdstringRequired

The unique id of the catalog.

Example: 787323

Body

Payload for updating a catalog.

nameall ofRequired

one ofOptional

Name of the catalog must be a string if the Content-Language header is set or a map of translations if the header is missing.

stringOptional

or

and

anyOptional

Name of the catalog must be a string if the Content-Language header is set or a map of translations if the header is missing.

descriptionall ofOptional

one ofOptional

Name of the catalog must be a string if the Content-Language header is set or a map of translations if the header is missing.

stringOptional

or

and

anyOptional

Description of the catalog must be a string if the Content-Language header is set or a map of translations if the header is missing.

publishedSitesstring[]Optional

List of site identifiers on which the catalog is published.

categoryIdsstring[]Optional

List of root category identifiers that are assigned to the catalog.

Responses

201

The catalog has been successfully created.

application/json

204

The catalog has been successfully updated.

400

Request was syntactically incorrect. Details will be provided in the response payload.

application/json

403

Permission denied due to insufficient rights.

application/json

404

Resource cannot be found

application/json

409

Resource conflict

application/json

500

An unexpected error prevented the server from fulfilling the request.

application/json

put

HTTPcURLJavaScriptPython

PUT /catalog/{tenant}/catalogs/{catalogId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 268

{
  "name": {
    "en": "This is the same catalog"
  },
  "description": {
    "en": "This catalog has been updated"
  },
  "visibility": {
    "visible": true,
    "from": "2022-02-24T20:44:43.169Z",
    "to": "2023-07-24T20:44:43.169Z"
  },
  "publishedSites": [
    "Main"
  ],
  "categoryIds": [
    "3249485"
  ],
  "metadata": {
    "version": 1
  }
}

{
  "id": "4239475"
}

Removing catalog

delete

Remove the specified catalog.

---

Required scopes

catalog.catalog_manage

Authorizations

Path parameters

tenantstringRequired

Your Emporix tenant's name. Note: The tenant should always be written in lowercase.

Example: saasdev2

catalogIdstringRequired

The unique id of the catalog.

Example: 787323

Responses

204

The catalog has been successfully removed.

400

Request was syntactically incorrect. Details will be provided in the response payload.

application/json

403

Permission denied due to insufficient rights.

application/json

404

Resource cannot be found

application/json

500

An unexpected error prevented the server from fulfilling the request.

application/json

delete

HTTPcURLJavaScriptPython

DELETE /catalog/{tenant}/catalogs/{catalogId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Partially updating a catalog

patch

Update the specified catalog, even partially.

---

Required scopes

catalog.catalog_manage

Authorizations

Path parameters

tenantstringRequired

Your Emporix tenant's name. Note: The tenant should always be written in lowercase.

Example: saasdev2

catalogIdstringRequired

The unique id of the catalog.

Example: 787323

Body

Payload for partially updating a catalog.

nameall ofOptional

one ofOptional

Name of the catalog must be a string if the Content-Language header is set or a map of translations if the header is missing.

stringOptional

or

and

anyOptional

Name of the catalog must be a string if the Content-Language header is set or a map of translations if the header is missing.

descriptionall ofOptional

one ofOptional

Name of the catalog must be a string if the Content-Language header is set or a map of translations if the header is missing.

stringOptional

or

and

anyOptional

Description of the catalog must be a string if the Content-Language header is set or a map of translations if the header is missing.

publishedSitesstring[]Optional

List of site identifiers on which the catalog is published.

categoryIdsstring[]Optional

List of root category identifiers that are assigned to the catalog.

Responses

204

The catalog has been successfully updated.

application/json

Responseone of

Name of the catalog must be a string if the Content-Language header is set or a map of translations if the header is missing.

stringOptional

or

400

Request was syntactically incorrect. Details will be provided in the response payload.

application/json

403

Permission denied due to insufficient rights.

application/json

500

An unexpected error prevented the server from fulfilling the request.

application/json

patch

HTTPcURLJavaScriptPython

PATCH /catalog/{tenant}/catalogs/{catalogId} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 268

{
  "name": {
    "en": "This is the same catalog"
  },
  "description": {
    "en": "This catalog has been updated"
  },
  "visibility": {
    "visible": true,
    "from": "2022-02-24T20:44:43.169Z",
    "to": "2023-07-24T20:44:43.169Z"
  },
  "publishedSites": [
    "Main"
  ],
  "categoryIds": [
    "3249485"
  ],
  "metadata": {
    "version": 1
  }
}

{
  "0": "t",
  "1": "e",
  "2": "x",
  "3": "t"
}