List Styles

Retrieve brand and featured styles available to your account.

GET/api/v1/styles

Behavior

Returns all styles accessible to the authenticated account. Brand styles (account-specific) are listed first, followed by up to 50 platform-curated featured styles.

Response Fields

Parameter	Type	Required	Description
styleId	string	Yes	UUID of the style
name	string	Yes	Display name
description	string \| null	No	Short description of the style (nullable)
coverImageUrl	string \| null	No	Preview image URL (nullable)
type	`"brand"` \| `"featured"`	Yes	Whether this is an account-specific brand style or a platform-curated featured style

Response

{
  "styles": [
    {
      "styleId": "a1b2c3d4-...",
      "name": "Brand Cinematic",
      "description": "Warm cinematic tones with film grain",
      "coverImageUrl": "https://storage.example.com/styles/brand-cinematic.webp",
      "type": "brand"
    },
    {
      "styleId": "e5f6a7b8-...",
      "name": "Neon Pop",
      "description": null,
      "coverImageUrl": null,
      "type": "featured"
    }
  ]
}