History: List creatives

Every change to this page, newest first. Expand an entry to see what changed.

2 Oct 2026 · +2 −1 lines

Show changes

⋯
  | `Wandura-API-Status` | all | API status. `beta` today, on every response, success or error. |
  | `Wandura-Version` | all | The dated API version (YYYY-MM-DD) this response was produced in: the version pinned to your API key, or the one you sent in the `Wandura-Version` request header. Keys created before dated versions existed use `2026-10-02`. |
+ | `Wandura-Request-Id` | all | An opaque id for this request (`req_` followed by 26 characters). Every response carries it, errors included, and error bodies repeat it as `request_id`. Log it, and quote it when you contact Wandura about a request: it finds the exact request in our logs. Do not parse it. |
  | `Deprecation` | 200 | Present only when this endpoint, or the dated version serving this response, is deprecated (RFC 9745): `@<unix seconds>` of the deprecation date. Log it in your monitoring. |
  | `Sunset` | 200 | Present only when a deprecated endpoint or dated version has a date when it stops working (RFC 8594), as an HTTP date. |
  | `Link` | 200 | Present with `Deprecation`: `<https://docs.wandura.ai/…>; rel="deprecation"` (and `rel="sunset"`) pointing to the page that explains what to use instead. |
- | `Cache-Control` | 200, 401, 403, 422, 503 | Always `no-store`. Do not cache these responses in shared caches. |
+ | `Cache-Control` | all | Always `no-store`. Do not cache these responses in shared caches. |
  | `Retry-After` | 429 | Seconds to wait before retrying. Sent with 429 and with retryable 503 responses. |
  | `X-RateLimit-Limit` | 429 | Requests (for playback, tickets) allowed per window for this endpoint group and your organisation. |
⋯

2 Oct 2026 · +1 −1 lines

Show changes

⋯
  ## Description
  
- Returns creatives of your organisation with status `approved` or `pushed`, ordered by `updated_at` ascending and then by ID. Records never contain a media URL. Every response, success or error (except `429`), is wrapped in the `{code, message, data, server_time}` envelope. See [Creatives](../concepts/creatives.md).
+ Returns creatives of your organisation with status `approved` or `pushed`, ordered by `updated_at` ascending and then by ID. Records never contain a media URL. Successful responses are wrapped in the `{code, message, data, server_time}` envelope; errors use the same envelope without `data`, except `429` and `400` `unsupported_version`, which use the flat format. See [Creatives](../concepts/creatives.md).
  
  ## Request parameters
⋯

2 Oct 2026 · +10 −0 lines

Show changes

⋯
  | `cursor` | query | string | No | The `next_cursor` from the previous page. Opaque; pass it back unchanged. |
  | `limit` | query | integer | No | Records per page, 1 to 100. Default `50`. |
+ | `Wandura-Version` | header | string | No | Optional. A dated API version (YYYY-MM-DD) to use for this request instead of the version pinned to your API key. Unknown or retired values answer 400 with `error_code` `unsupported_version`. |
  
  You can combine `updated_since` and `cursor`. Keep the same `updated_since` on every page of one sync. Because `updated_at` in each record is rounded down to the second, passing the largest `updated_at` you received usually returns the last records again; overwrite them by `creative_id`.
⋯
  | `data.next_cursor` | string or null | Pass it as `cursor` to get the next page. `null` on the last page. |
  | `server_time` | integer | Server time in Unix epoch seconds. |
+ | `links` | object | Ready-made absolute URLs of this page — follow `links.next` instead of building the next-page URL. |
+ | `links.self` | string | This request. |
+ | `links.next` | string or null | The next page, or `null` on the last page. |
  
  ### The creative record
⋯
  | Field | Type | Description |
  |---|---|---|
+ | `links` | object | Ready-made absolute URL of this creative's own endpoint (an API link, not a media URL). |
  | `schema_version` | integer | Record schema version. Currently `1`. Additive fields do not change it. |
  | `creative_id` | string (UUID) | Stable creative ID. |
⋯
  |---|---|---|
  | `Wandura-API-Status` | all | API status. `beta` today, on every response, success or error. |
+ | `Wandura-Version` | all | The dated API version (YYYY-MM-DD) this response was produced in: the version pinned to your API key, or the one you sent in the `Wandura-Version` request header. Keys created before dated versions existed use `2026-10-02`. |
+ | `Deprecation` | 200 | Present only when this endpoint, or the dated version serving this response, is deprecated (RFC 9745): `@<unix seconds>` of the deprecation date. Log it in your monitoring. |
+ | `Sunset` | 200 | Present only when a deprecated endpoint or dated version has a date when it stops working (RFC 8594), as an HTTP date. |
+ | `Link` | 200 | Present with `Deprecation`: `<https://docs.wandura.ai/…>; rel="deprecation"` (and `rel="sunset"`) pointing to the page that explains what to use instead. |
  | `Cache-Control` | 200, 401, 403, 422, 503 | Always `no-store`. Do not cache these responses in shared caches. |
  | `Retry-After` | 429 | Seconds to wait before retrying. Sent with 429 and with retryable 503 responses. |
⋯
  | Status | `code` | When |
  |---|---|---|
+ | 400 | none | The `Wandura-Version` header, or the version pinned to your key, is unknown or retired. The body adds `supported_versions` and `latest_version` (and `upgrade_to` when your pin was retired). |
  | 401 | 4010 | The `Authorization: Bearer` header is missing. |
  | 401 | 4011 | The key is unknown or revoked. |
⋯

2 Oct 2026 · +23 −5 lines

Show changes

⋯
  | `code` | integer | `0`. |
  | `message` | string | `"ok"`. |
- | `data.items` | array | The creative records on this page. See [The creative record](#the-creative-record). |
+ | `data.items` | array | The creative records on this page. |
  | `data.next_cursor` | string or null | Pass it as `cursor` to get the next page. `null` on the last page. |
  | `server_time` | integer | Server time in Unix epoch seconds. |
⋯
  | Field | Type | Description |
  |---|---|---|
- | `schema_version` | integer | Record schema version. Currently `1`. |
+ | `schema_version` | integer | Record schema version. Currently `1`. Additive fields do not change it. |
  | `creative_id` | string (UUID) | Stable creative ID. |
  | `creative_code` | string or null | Immutable human-readable code. Treat it as opaque. |
⋯
  | `placement` | string or null | `reels_9x16`, `feed_4x5` or `square_1x1`. |
  | `aspect` | string or null | `9:16`, `4:5` or `1:1`, matching `placement`. |
- | `duration_ms` | integer | Total length of the film clips used, in milliseconds. |
+ | `duration_ms` | integer | Total length of the film clips used, in milliseconds. Can be shorter than the final video, because `scenes` lists only clips taken from film episodes. |
  | `scenes` | array | The film clips used, in order. |
  | `scenes[].episode_no` | integer or null | Episode the clip comes from. |
⋯
  | `scenes[].line` | string or null | The spoken line or standout line of the scene. |
  | `hook` | object or null | `action` and `line` of the first scene. `null` when there are no scenes. |
- | `formula` | object or null | `{ "name": ... }` of the formula the creative was built with. |
+ | `formula` | object or null | The formula the creative was built with. |
+ | `formula.name` | string | Formula name. |
  | `rights.ends_at` | integer or null | Last day of your export rights for the film, as Unix seconds at 00:00 UTC of that day. Your rights include that whole day: stop using the creative after that UTC day ends, that is at `ends_at + 86400`. `null` when Wandura has no end date on record for your export rights. |
  | `lineage.parent_creative_id` | string (UUID) or null | The creative this one was derived from. |
⋯
          "duration_ms": 21500,
          "scenes": [
-           { "episode_no": 1, "start_ms": 12000, "end_ms": 19500, "duration_ms": 7500, "action": "reveal", "line": "You threw me out. Now watch me take it all back." },
+           {
+             "episode_no": 1,
+             "start_ms": 12000,
+             "end_ms": 19500,
+             "duration_ms": 7500,
+             "action": "reveal",
+             "line": "You threw me out. Now watch me take it all back."
+           },
            { "episode_no": 2, "start_ms": 40000, "end_ms": 54000, "duration_ms": 14000, "action": null, "line": null }
          ],
⋯
  ```
  
+ ## Response headers {#response-headers}
+ 
+ | Header | Responses | Description |
+ |---|---|---|
+ | `Wandura-API-Status` | all | API status. `beta` today, on every response, success or error. |
+ | `Cache-Control` | 200, 401, 403, 422, 503 | Always `no-store`. Do not cache these responses in shared caches. |
+ | `Retry-After` | 429 | Seconds to wait before retrying. Sent with 429 and with retryable 503 responses. |
+ | `X-RateLimit-Limit` | 429 | Requests (for playback, tickets) allowed per window for this endpoint group and your organisation. |
+ | `X-RateLimit-Window` | 429 | Window length in seconds. |
+ 
  ## Errors
  
⋯

2 Oct 2026 · Page created