List computer snapshots

GET/v1/environments/{environmentId}/snapshots

List canonical snapshots captured for a computer workspace.

How to call this endpoint

Every ACP API request uses bearer authentication. The examples here show the actual request path, auth header, and body shape that the platform expects.

Path, query, and header parameters

These parameters control which ACP object the endpoint acts on and how the request is processed.

Path parameters
NameLocationTypeRequiredDescription
environmentIdpathstringYesEnvironment ID
Query parameters
NameLocationTypeRequiredDescription
limitqueryintegerNo
offsetqueryintegerNo

Body schema

This endpoint does not require a request body.

None.

What the API returns

Each response code below includes the documented payload shape for the ACP API.

200Snapshot listapplication/json
FieldTypeRequiredDescription
objectstringNo
dataobject[]No
data[].idstringNoUnique identifier.
data[].environmentIdstringNoComputer ID.
data[].sourceThreadIdstringNo
data[].sourceStepIdstringNo
data[].parentSnapshotIdstringNo
data[].ledgerCommitShastringNo
data[].changedPathsstring[]No
data[].additionsintegerNo
data[].deletionsintegerNo
data[].metadataobjectNoFree-form metadata object.
data[].createdAtstringNoISO 8601 timestamp.
List computer snapshots
Loading...
Response 200
Loading...
See the ACP quickstart and SDK flow