> For the complete documentation index, see [llms.txt](https://docs.denvrdata.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.denvrdata.com/docs/api-reference/snapshots.md).

# Snapshots

## GET /api/v1/servers/snapshots/GetSnapshots

> Get list of snapshots.

```json
{"openapi":"3.0.4","info":{"title":"DenvrCloud API","version":"v1"},"tags":[{"name":"servers/snapshots"}],"paths":{"/api/v1/servers/snapshots/GetSnapshots":{"get":{"tags":["servers/snapshots"],"summary":"Get list of snapshots.","operationId":"ApiV1ServersSnapshotsGetsnapshotsGet","parameters":[{"name":"Cluster","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/ListResultDtoOfSnapshotDetailsItem"}},"application/json":{"schema":{"$ref":"#/components/schemas/ListResultDtoOfSnapshotDetailsItem"}},"text/json":{"schema":{"$ref":"#/components/schemas/ListResultDtoOfSnapshotDetailsItem"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}}}}},"components":{"schemas":{"ListResultDtoOfSnapshotDetailsItem":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SnapshotDetailsItem"},"nullable":true}},"additionalProperties":false},"SnapshotDetailsItem":{"type":"object","properties":{"id":{"type":"string","nullable":true},"namespace":{"type":"string","nullable":true},"sourceName":{"type":"string","nullable":true},"osImage":{"type":"string","nullable":true},"customPackage":{"type":"string","nullable":true},"rootDiskSize":{"type":"string","nullable":true},"creationDate":{"type":"string","format":"date-time"},"username":{"type":"string","nullable":true},"tenancyName":{"type":"string","nullable":true},"readyToUse":{"type":"boolean"}},"additionalProperties":false}}}}
```

## GET /api/v1/servers/snapshots/GetSnapshot

> Get detailed information on specific snapshot.

```json
{"openapi":"3.0.4","info":{"title":"DenvrCloud API","version":"v1"},"tags":[{"name":"servers/snapshots"}],"paths":{"/api/v1/servers/snapshots/GetSnapshot":{"get":{"tags":["servers/snapshots"],"summary":"Get detailed information on specific snapshot.","operationId":"ApiV1ServersSnapshotsGetsnapshotGet","parameters":[{"name":"Id","in":"query","description":"Name of snapshot","required":true,"schema":{"type":"string"}},{"name":"Namespace","in":"query","description":"The namespace/vpc.","required":true,"schema":{"type":"string"}},{"name":"Cluster","in":"query","description":"The cluster you're operating on","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/SnapshotDetailsItem"}},"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotDetailsItem"}},"text/json":{"schema":{"$ref":"#/components/schemas/SnapshotDetailsItem"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}}}}},"components":{"schemas":{"SnapshotDetailsItem":{"type":"object","properties":{"id":{"type":"string","nullable":true},"namespace":{"type":"string","nullable":true},"sourceName":{"type":"string","nullable":true},"osImage":{"type":"string","nullable":true},"customPackage":{"type":"string","nullable":true},"rootDiskSize":{"type":"string","nullable":true},"creationDate":{"type":"string","format":"date-time"},"username":{"type":"string","nullable":true},"tenancyName":{"type":"string","nullable":true},"readyToUse":{"type":"boolean"}},"additionalProperties":false}}}}
```

## POST /api/v1/servers/snapshots/CreateSnapshot

> Create a new snapshot from an existing virtual machine.

```json
{"openapi":"3.0.4","info":{"title":"DenvrCloud API","version":"v1"},"tags":[{"name":"servers/snapshots"}],"paths":{"/api/v1/servers/snapshots/CreateSnapshot":{"post":{"tags":["servers/snapshots"],"summary":"Create a new snapshot from an existing virtual machine.","operationId":"ApiV1ServersSnapshotsCreatesnapshotPost","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSnapshotInput"}},"text/json":{"schema":{"$ref":"#/components/schemas/CreateSnapshotInput"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/CreateSnapshotInput"}}}},"responses":{"202":{"description":"Accepted","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/SnapshotDetailsItem"}},"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotDetailsItem"}},"text/json":{"schema":{"$ref":"#/components/schemas/SnapshotDetailsItem"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}}},"components":{"schemas":{"CreateSnapshotInput":{"required":["cluster","namespace"],"type":"object","properties":{"name":{"type":"string","nullable":true},"namespace":{"minLength":1,"type":"string"},"cluster":{"minLength":1,"type":"string"},"sourceVMName":{"type":"string","nullable":true}},"additionalProperties":false},"SnapshotDetailsItem":{"type":"object","properties":{"id":{"type":"string","nullable":true},"namespace":{"type":"string","nullable":true},"sourceName":{"type":"string","nullable":true},"osImage":{"type":"string","nullable":true},"customPackage":{"type":"string","nullable":true},"rootDiskSize":{"type":"string","nullable":true},"creationDate":{"type":"string","format":"date-time"},"username":{"type":"string","nullable":true},"tenancyName":{"type":"string","nullable":true},"readyToUse":{"type":"boolean"}},"additionalProperties":false}}}}
```

## DELETE /api/v1/servers/snapshots/DeleteSnapshot

> Delete snapshot.

```json
{"openapi":"3.0.4","info":{"title":"DenvrCloud API","version":"v1"},"tags":[{"name":"servers/snapshots"}],"paths":{"/api/v1/servers/snapshots/DeleteSnapshot":{"delete":{"tags":["servers/snapshots"],"summary":"Delete snapshot.","operationId":"ApiV1ServersSnapshotsDeletesnapshotDelete","parameters":[{"name":"Id","in":"query","description":"Name of snapshot","required":true,"schema":{"type":"string"}},{"name":"Namespace","in":"query","description":"The namespace/vpc.","required":true,"schema":{"type":"string"}},{"name":"Cluster","in":"query","description":"The cluster you're operating on","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"Accepted","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/SnapshotCommandOutput"}},"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotCommandOutput"}},"text/json":{"schema":{"$ref":"#/components/schemas/SnapshotCommandOutput"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}}}}},"components":{"schemas":{"SnapshotCommandOutput":{"type":"object","properties":{"id":{"type":"string","nullable":true}},"additionalProperties":false}}}}
```