API referenceCreative Templates

List creative templates

Lists the brand's saved creative templates, newest first, with their html, slots and preview.

GET
/v1/brands/{brandId}/creative-templates
bearerAuth
headerAuthorizationBearer <token>

An organization API key (koast_sk_…) with the API surface enabled, or an OAuth access token issued by Koast (koast_at_…) whose audience covers this API. REST access requires an active Agency plan.

brandId*integer

The brand the request acts on. Every brand-scoped resource lives under its brand.

Response Body

List creative templates

application/json
  1. response
templates*array<>
[key: string]?unknown
curl -X GET "https://example.com/v1/brands/0/creative-templates" \  -H "Authorization: Bearer koast_sk_..."
{  "templates": [    {      "templateId": -9007199254740991,      "name": "string",      "aspectRatio": "string",      "slots": [        {          "name": "string",          "description": "string",          "property1": null,          "property2": null        }      ],      "referenceUrl": "string",      "previewCreativeId": -9007199254740991,      "previewUrl": "string",      "html": "string",      "createdAt": "string",      "property1": null,      "property2": null    }  ],  "property1": null,  "property2": null}

Required scope: read. CLI: koast list-creative-templates, see Creative Templates commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.