Slot Preview AI

Export manifests

A single-game export archive contains manifest.csv and manifest.json. A batch archive contains one manifest.csv for the whole batch. CSV follows RFC 4180 and includes a header row. An empty CSV field represents a missing value; the corresponding JSON value is null.

The column order below is part of the API contract. New columns are appended without moving existing ones.

Single-export manifest.csv

Column:pathMeaning:File path relative to the archive root.
Column:formatMeaning:Slot Preview AI format code.
Column:widthMeaning:Image width in pixels.
Column:heightMeaning:Image height in pixels.
Column:bytesMeaning:File size in bytes.
Column:mimeMeaning:Actual MIME type of the file.
Column:sha256Meaning:SHA-256 checksum of the file bytes.
Column:gameMeaning:Game slug used in archive paths.
Column:providerMeaning:Provider slug used in archive paths.
Column:notesMeaning:Delivery warnings, or an empty field when there are none.
Column:game_idMeaning:Canonical Slot Preview AI game ID.
Column:provider_idMeaning:Slot Preview AI provider ID.
Column:operator_game_idMeaning:Your organization's game ID, or an empty field if not set.
Column:operator_provider_idMeaning:Your organization's provider ID, or an empty field if not set.
Column:master_idMeaning:ID of the master used to build the set.
Column:statusMeaning:Delivery status. Every file listed in this CSV has ready.

A multi-container archive has a self-contained manifest in each container folder. All container manifests carry the same five identity values.

Batch manifest.csv

Column:pathMeaning:File path relative to the archive root. Empty for an undelivered file.
Column:providerMeaning:Provider slug used in archive paths.
Column:game_slugMeaning:Game slug used in archive paths.
Column:external_idMeaning:The exact external ID submitted with this batch row. This is not the operator game binding.
Column:formatMeaning:Slot Preview AI format code.
Column:widthMeaning:Image width in pixels. Empty for an undelivered file.
Column:heightMeaning:Image height in pixels. Empty for an undelivered file.
Column:bytesMeaning:File size in bytes. Empty for an undelivered file.
Column:mimeMeaning:Actual MIME type of the file. Empty for an undelivered file.
Column:sha256Meaning:SHA-256 checksum of the file bytes. Empty for an undelivered file.
Column:statusMeaning:Delivery status for this row: ready for a delivered file, otherwise the existing non-delivery status.
Column:reasonMeaning:Reason for non-delivery. Empty when the file is ready.
Column:overlay_config_idMeaning:Caption configuration ID, or an empty field when no caption was applied.
Column:layers_hashMeaning:Hash of the caption layer dictionary, or an empty field when no caption was applied.
Column:overlay_suppressed_reasonMeaning:Why the caption was omitted, or an empty field when not applicable.
Column:game_idMeaning:Canonical Slot Preview AI game ID.
Column:provider_idMeaning:Slot Preview AI provider ID.
Column:operator_game_idMeaning:Your organization's game ID, or an empty field if not set.
Column:operator_provider_idMeaning:Your organization's provider ID, or an empty field if not set.
Column:master_idMeaning:ID of the master used for this row, or an empty field when there is no master.

The batch CSV has one row for every promised file, including files that were not delivered. For an unmatched row, game_id, provider_id, both operator IDs and master_id are empty.

Single-export manifest.json

The JSON manifest describes the same build as the CSV. Its top-level identity fields are always present and nullable.

Field:export_set_idMeaning:Export set ID, or null when unavailable.
Field:gameMeaning:Game slug.
Field:providerMeaning:Provider slug.
Field:statusMeaning:Set delivery status: succeeded or partial.
Field:files_totalMeaning:Number of delivered and missing ordered files.
Field:files_readyMeaning:Number of delivered files.
Field:warningsMeaning:Delivery warnings for the archive.
Field:files[]Meaning:Delivered files. Each entry has status: "ready" together with its path, format, dimensions, size, MIME type and checksum.
Field:missing[]Meaning:Ordered files that were not delivered, with their delivery status and reason.
Field:overlayMeaning:Caption configuration snapshot, or null.
Field:game_idMeaning:Canonical Slot Preview AI game ID.
Field:provider_idMeaning:Slot Preview AI provider ID.
Field:operator_game_idMeaning:Your organization's game ID, or null.
Field:operator_provider_idMeaning:Your organization's provider ID, or null.
Field:master_idMeaning:ID of the master used to build the set, or null.

A narrowed delivery can also contain formats_entitled, formats_ordered, formats_delivered and not_selected.

Operator game and provider IDs

external_id in POST /v1/masters is not a game ID binding. In a batch manifest, external_id is only the value submitted with that row. Neither value is copied into the operator ID store. Set the persistent organization binding explicitly and reconcile any difference on your side.

The paths below are relative to the versioned API base URL.

Operation:PUT /games/{id}/operator-idContract:Sets or replaces the game binding. Body: {"operator_game_id":"..."}. Returns the canonical game_id, value, updated_at and conflicts.
Operation:DELETE /games/{id}/operator-idContract:Removes the game binding. Returns 204, including when no value was set.
Operation:PUT /providers/{id}/operator-idContract:Sets or replaces the provider binding. Body: {"operator_provider_id":"..."}. Returns provider_id, value, updated_at and conflicts.
Operation:DELETE /providers/{id}/operator-idContract:Removes the provider binding. Returns 204, including when no value was set.
Operation:GET /operator-idsContract:Lists bindings. kind=game or kind=provider is required. Optional operator_id filters by exact, case-sensitive equality; limit defaults to 50 and accepts up to 100; cursor continues the feed.

An operator ID contains 1 to 128 Unicode code points, with no control characters and no leading or trailing whitespace. It is stored and returned byte-exact and case-sensitive. Invalid values receive 400 validation_failed. The validation issue path names the rejected field.

Duplicate values are allowed. A successful write reports other visible records with the same value in conflicts, up to 100 entries. Repeating an unchanged value leaves updated_at unchanged.

Writes require the export scope and the feed requires read. These operations are free and return X-Tokens-Charged: 0.

Sandbox warning: a test key reads and changes the same organization bindings as a live key. A test write therefore affects subsequent production exports.

Snapshot, current values and webhooks

An archive is a snapshot of its build. Changing an operator ID does not change an existing archive or its checksum; the next build writes the new value.

GET /v1/exports/{id} and MCP get_export answer with current values. The export webhook carries the identity values of the build it announces, matching that build's manifest. Retried delivery sends the same stored event body, not newly read values. A webhook for a later build carries the later build's values.

Delivery status is not approval

ready means that the file was built and delivered. It does not mean manual approval. Approval is kept on your side.

Set-level status describes delivery as succeeded or partial. It is separate from the per-file status and from any design or CMS workflow status.

Spreadsheet-leading characters

Operator IDs and batch external IDs that start with =, +, - or @ are returned unchanged. This is a machine-readable contract: RFC 4180 escaping preserves CSV structure but does not add spreadsheet formula protection. Use a CSV parser for imports and apply your own policy if you open the file in a spreadsheet editor.