> ## Documentation Index
> Fetch the complete documentation index at: https://docs.falkordb.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Create snapshot

> Take a manual snapshot of a deployment instance.

Creates a manual snapshot of a deployment instance. Snapshotting is asynchronous: the call returns immediately and the snapshot progresses from `pending` to `completed`. Poll [Describe snapshot](/api-reference/snapshots/describe) to follow the `progress` field.

## Authorization

<ParamField header="Cookie" type="string" required>
  Session cookie set by [Sign in](/api-reference/authentication/signin): `omnistrate_token=<jwt>`.
</ParamField>

## Query parameters

<ParamField query="subscriptionId" type="string">
  Subscription that owns the instance. Required when you belong to more than one subscription.
</ParamField>

## Body

<ParamField body="instanceId" type="string" required>
  ID of the deployment instance to snapshot.
</ParamField>

<ParamField body="targetRegion" type="string">
  Region to store the snapshot in. Defaults to the instance region.
</ParamField>

```json Request theme={null}
{
  "instanceId": "instance-abc123"
}
```

## Response

Returns `202 Accepted`.

<ResponseField name="id" type="string">
  ID of the orchestration that creates the snapshot.
</ResponseField>

## Errors

See [Error](/api-reference/schemas#error) for the error response shape.