OCocoya
Studio designs

List Studio designs

Changed on

Returns the brand's own designs saved in Ocoya Studio, newest first. For Ocoya's public template gallery, use GET /studio-templates.

get/studio-designs

Request

  • Base URL
    https://www.app.ocoya.com/api/_public/v1
  • Auth
    API key in header X-API-Key

Query parameters

brandIdstring required
Example:cmayvq3hk00017apshay5qezu

Ocoya brand ID. Get one from GET /brands.

querystring
Example:Launch

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

pageinteger

Zero-based page number for paginated results.

perPageinteger
Example:20

Maximum number of items to return per page.

Response

Success

totalinteger required

Designs matching the query.

Example response

{
  "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"
    }
  ]
}

Changes