---
title: "List layer snapshots"
method: GET
path: "/clouddiagrams/v1/statussheet/{id}/snapshots"
tags: ["Cloud Diagrams"]
---

# List layer snapshots

`GET /clouddiagrams/v1/statussheet/{id}/snapshots`

## Request

- Base URL: `https://api.doit.com`
- URL: `https://api.doit.com/clouddiagrams/v1/statussheet/{id}/snapshots`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-Tenant-Id` and API key in header `Authorization`

Returns the list of saved snapshots for the specified diagram layer.

## Path parameters

- `id` string, required

## Query parameters

- `offset` integer
- `limit` integer
- `sort` string

## Response `200`

OK - Snapshots returned.

- CloudDiagramLayerSnapshot[]
  - `_id` string, required: Snapshot ID.
  - `name` string: Snapshot name.
  - `createdAt` string, date-time, required: Timestamp when the snapshot was created.
  - `prevState` string: ID of the previous snapshot in the chain.

## Other responses

- `400`: Bad Request - The server cannot process the request, often due to a malformed request.
- `401`: Unauthorized - Invalid API key.
- `403`: Forbidden - Either the resource does not exist, or the caller is not authorized to access it. These two cases are deliberately indistinguishable to avoid information disclosure: the access guard runs before any existence check, so callers receive 403 (not 404) for unknown IDs on this endpoint. Used by Cloud Diagrams routes keyed by a path-param resource id (e.g. `/clouddiagrams/v1/statussheet/{id}/...`).

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) - [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) - [OpenAPI document](https://skmtc.dev/doit/apis/doit-cloud-intelligence/revisions/9416402fc119?raw)