GET
https://www.app.ocoya.com/api/_public/v1/studio-designs
List Studio designs
curl --request GET \
  --url https://www.app.ocoya.com/api/_public/v1/studio-designs \
  --header 'X-API-Key: <api-key>'
{
  "total": 1,
  "data": [
    {
      "id": "design_123",
      "name": "Weekly offer",
      "thumbnail": "https://perma.pixy.art/preview.png",
      "pagesCount": 1,
      "width": 1080,
      "height": 1080,
      "updatedAt": "2026-10-25T10:08:00.000Z"
    }
  ]
}

Authorizations

X-API-Keystringheaderrequired

Your API key. Create one in Ocoya. Authorization: Bearer <key> works too.

Query Parameters

brandIdstringrequired

Ocoya brand ID. Get one from GET /brands.

Example:"cmayvq3hk00017apshay5qezu"
querystring

Search query used to filter results by name or matching text.

Example:"Launch"
pageinteger

Zero-based page number for paginated results.

Example:0
perPageinteger

Maximum number of items to return per page.

Example:20

Response

application/json

Success

totalinteger

Designs matching the query.

Example:1
dataobject[]

This page of designs, newest first.

Show child attributesHide child attributes
data.idstring

Studio design ID. Pass it as studioDesignId to POST /post/ai or POST /campaigns, or render it with POST /studio-designs/{designId}/render.

Example:"design_123"
data.namestring

Design name. Untitled design when it has none.

Example:"Weekly offer"
data.thumbnailstring | null

Preview image URL.

Example:"https://perma.pixy.art/preview.png"
data.pagesCountinteger

Number of pages in the design.

Example:1
data.widthnumber | null

Design width in pixels.

Example:1080
data.heightnumber | null

Design height in pixels.

Example:1080
data.updatedAtstring | null

When the design was last saved.

Example:"2026-10-25T10:08:00.000Z"