Versions

3 endpoints for working with versions.

List versions

get/decks/{id}/versionslist_deck_versions

Lists a skroll's version history, newest first. Content is omitted; fetch a version to get it.

Example request

curl

curl -X GET https://skrollai.com/api/v1/decks/0b1e0f7c-1c3f-4a0e-9f5a-1a2b3c4d5e6f/versions \
  -H "Authorization: Bearer sk_..."

Parameters

Parameter	In	Type	Description
id*	path	string (uuid)	n/a

Responses

200Versions

Array of DeckVersionSummary

Field	Type	Description
id*	string (uuid)	n/a
version*	integer	n/a
prompt*	string \| null	The brief that produced this version
createdAt*	string (date-time)	n/a

401Missing, malformed, unknown or revoked API key

403The key's creator lacks access

404Resource not found

422Input failed validation

429Rate limit exceeded. See the Retry-After header

500Unexpected server error

Get a version

get/decks/{id}/versions/{version}get_deck_version

Returns one version of a skroll including its full content (deck-tsx source, compiled module and theme tokens).

Example request

curl

curl -X GET https://skrollai.com/api/v1/decks/0b1e0f7c-1c3f-4a0e-9f5a-1a2b3c4d5e6f/versions/3 \
  -H "Authorization: Bearer sk_..."

Parameters

Parameter	In	Type	Description
id*	path	string (uuid)	n/a
version*	path	integer	n/a

Responses

200The version

401Missing, malformed, unknown or revoked API key

403The key's creator lacks access

404Resource not found

422Input failed validation

429Rate limit exceeded. See the Retry-After header

500Unexpected server error

Revert to a version

post/decks/{id}/versions/{version}/revertrevert_deck_version

Copies an earlier version's content forward as a new newest version. History is preserved. Consumes one version edit.

Example request

curl

curl -X POST https://skrollai.com/api/v1/decks/0b1e0f7c-1c3f-4a0e-9f5a-1a2b3c4d5e6f/versions/3/revert \
  -H "Authorization: Bearer sk_..."

Parameters

Parameter	In	Type	Description
id*	path	string (uuid)	n/a
version*	path	integer	n/a

Responses

200The new version

VersionWriteResult

Field	Type	Description
id*	string (uuid)	n/a
version*	integer	n/a

401Missing, malformed, unknown or revoked API key

402Out of allowance for a metered feature

403The key's creator lacks access

404Resource not found

422Input failed validation

429Rate limit exceeded. See the Retry-After header

500Unexpected server error