Channel Route Operations - Bloomreach Experience - The Headless Digital Experience Platform Built for Commerce

Channel Route Operations

GET​ /channels​/{channel_id}​/routes

Get the channel route.

Parameters

Name Description

channel_id *

string

(path)

Channel id. Optionally includes the project id, separated by a dash: mychannel-branchId

Example : brxsaas-vIUy9

Responses

Code Description
200

OK

Media type: application/json

Schema: [Route]

Example:

[
  {
    "name": "products",
    "layout": null,
    "pageTitle": null,
    "relativeContentPath": null,
    "referenceId": null,
    "parameters": {},
    "doctypePages": {},
    "items": [
      {
        "name": "_any_",
        "layout": "product",
        "pageTitle": null,
        "relativeContentPath": "pages/products/${1}",
        "referenceId": null,
        "parameters": {},
        "doctypePages": {},
        "items": []
      }
    ]
  }
]
403

Forbidden

GET ​/channels​/{channel_id}​/routes​/{route_name}

Get a route.

Parameters

Name Description

channel_id *

string

(path)

Channel id. Optionally includes the project id, separated by a dash: mychannel-branchId

Example : brxsaas-vIUy9

route_name *

string

(path)

Name of route

Example : products

Responses

Code Description
200

OK

Media type: application/json

Schema: Route

Example:

{
  "name": "products",
  "layout": null,
  "pageTitle": null,
  "relativeContentPath": null,
  "referenceId": null,
  "parameters": {},
  "doctypePages": {},
  "items": [
    {
      "name": "_any_",
      "layout": "product",
      "pageTitle": null,
      "relativeContentPath": "pages/products/${1}",
      "referenceId": null,
      "parameters": {},
      "doctypePages": {},
      "items": []
    }
  ]
}

Headers:

Name Description Type
X-Resource-Version

Resource's version. Must be used in any subsequent update requests of this resource

string
403

Forbidden

404

Not Found

PUT ​/channels​/{channel_id}​/routes​/{route_name}

Create or update a route.

Parameters

Name Description

X-Resource-Version

string

(header)

Resource's version. Must be used in any subsequent update requests of this resource. Can be obtained when GETting the resource

Example : 433cc90445d29c2356e385b9efe548b19ed86739f27eb7958a81847b9d8517c2

channel_id *

string

(path)

Channel id. Optionally includes the project id, separated by a dash: mychannel-branchId

Example : brxsaas-vIUy9

route_name *

string

(path)

Name of route

Example : products

Request body

application/json

Schema: Route

Example:

{
  "name": "products",
  "layout": null,
  "pageTitle": null,
  "relativeContentPath": null,
  "referenceId": null,
  "parameters": {},
  "doctypePages": {},
  "items": [
    {
      "name": "_any_",
      "layout": "product",
      "pageTitle": null,
      "relativeContentPath": "pages/products/${1}",
      "referenceId": null,
      "parameters": {},
      "doctypePages": {},
      "items": []
    }
  ]
}

Responses

Code Description
200

OK

Media type: application/json

Schema: Route

Example:

{
  "name": "products",
  "layout": null,
  "pageTitle": null,
  "relativeContentPath": null,
  "referenceId": null,
  "parameters": {},
  "doctypePages": {},
  "items": [
    {
      "name": "_any_",
      "layout": "product",
      "pageTitle": null,
      "relativeContentPath": "pages/products/${1}",
      "referenceId": null,
      "parameters": {},
      "doctypePages": {},
      "items": []
    }
  ]
}

Headers:

Name Description Type
X-Resource-Version

Resource's version. Must be used in any subsequent update requests of this resource

string
201

Created

Media type: application/json

Schema: Route

Example:

{
  "name": "products",
  "layout": null,
  "pageTitle": null,
  "relativeContentPath": null,
  "referenceId": null,
  "parameters": {},
  "doctypePages": {},
  "items": [
    {
      "name": "_any_",
      "layout": "product",
      "pageTitle": null,
      "relativeContentPath": "pages/products/${1}",
      "referenceId": null,
      "parameters": {},
      "doctypePages": {},
      "items": []
    }
  ]
}

Headers:

Name Description Type
X-Resource-Version

Resource's version. Must be used in any subsequent update requests of this resource

string
403

Forbidden

DELETE ​/channels​/{channel_id}​/routes​/{route_name}

Delete a route.

Parameters

Name Description

channel_id *

string

(path)

Channel id. Optionally includes the project id, separated by a dash: mychannel-branchId

Example : brxsaas-vIUy9

route_name *

string

(path)

Name of route

Example : products

Responses

Code Description
200

OK

204

No Content

403

Forbidden

Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?