API referenceSnapshot Templates

List campaign snapshot templates

Lists the saved campaign snapshot templates. Results are cursor-paginated.

GET
/v1/brands/{brandId}/snapshot-templates

Authorization

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.

Path Parameters

brandId*integer

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

Query Parameters

cursor?string

Opaque cursor from the previous page's nextCursor. Omit for the first page.

limit?integer

Page size.

Range1 <= value <= 100
Default50

Response Body

List campaign snapshot templates

application/json
  1. response
templates*array<>
nextCursor*|

Pass as cursor to read the next page. Null when there is no next page.

[key: string]?unknown
curl -X GET "https://example.com/v1/brands/0/snapshot-templates" \  -H "Authorization: Bearer koast_sk_..."
{  "templates": [    {      "id": "string",      "property1": null,      "property2": null    }  ],  "nextCursor": "string",  "property1": null,  "property2": null}

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

Create pipeline card

Creates a pipeline card (a draft launch) titled title. Optionally set its starting stage (defaults to REQUESTED), attach creativeIds and assign teammates with assigneeIds.

Delete campaign snapshot template

Permanently deletes the campaign snapshot template. Structure templates are not affected.