Developers
Showcases

List showcases

GET/showcases

Lists showcases and showcase groups in the account, ordered by position and paginated with a cursor.

By default, only top-level items are returned; use parent_id to list the showcases inside a group. The collection can also be filtered by status, kind, and name (q). Set deleted=true to list showcases in the trash instead of active ones.

Credentials limited to specific showcases only see those showcases.

Authorization

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Query Parameters

limit?integer
Range1 <= value <= 200
cursor?string
sort?string

Value in

  • "position"
  • "-position"
parent_id?string
status?string

Value in

  • "published"
  • "draft"
  • "unlisted"
  • "hidden"
kind?string

Value in

  • "group"
  • "showcase"
deleted?boolean
q?string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/showcases"
{  "data": [    {      "created_at": "2019-08-24T14:15:22Z",      "deleted": true,      "id": "string",      "image": "string",      "kind": "group",      "name": "string",      "object": "showcase",      "parent_id": "string",      "position": 0,      "products_count": 0,      "revision": "string",      "status": "published",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "page": {    "limit": 1,    "next_cursor": "string",    "prev_cursor": "string"  }}

Showcases

Showcases in API v3: list showcases, create a showcase, reorder showcases, retrieve a showcase, update a showcase, delete a showcase, duplicate a showcase, list showcase products, reorder showcase products.

Create a showcase POST

Creates a showcase or a showcase group. New showcases and groups are always created with the `draft` status. Showcases follow a two-level hierarchy: groups exist only at the top level and can contain showcases. To create a showcase inside a group, set `parent_id` to the group's public ID; if `parent_id` does not reference a group, the request is rejected with `hierarchy_violation`. A showcase created inside a group is always created with the `showcase` kind.