List a script's versions

Returns the versions of a script's chain as a page, newest versionNumber first by default, each item reporting the version's identity and status — never its code. The path id may be any version in the chain: it is resolved to the chain's rootScriptId, so every version's id returns the same history.

Soft-deleted (DELETED) versions are left out, and requesting the history through a deleted version's id is refused with 404 like every other read of a deleted script.

Pagination matches the other listings: page is zero-based, size defaults to 20 within [1, 100], and sort takes field[,asc|desc], here defaulting to versionNumber,desc.

Path Params
uuid
required

Id of the script.

Query Params
integer
Defaults to 0

Zero-based page number; must not be negative.

integer
≤ 100
Defaults to 20

Page size, default 20. A value above 100 returns 100; a value below 1 returns 1.

string
Defaults to versionNumber,desc

Sort field and direction as field[,asc|desc]; the direction defaults to desc.

Headers
string
^\d+\.\d+\.\d+$

Version of the API contract the client targets, in MAJOR.MINOR.PATCH format. Mandated by the Gateway standard. Not yet enforced: requests without the header, or with an unsupported value, are currently processed normally. Once enforcement is enabled, such requests will be rejected with 400 Bad Request.

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json