# Order more snapshot storage

> Add snapshot storage to your account when your servers' snapshots need more room than their plans include.

Source: https://www.coritan.com/docs/snapshots/add-snapshot-storage/

In the dashboard:

- /dashboard/snapshots: https://www.coritan.com/dashboard/snapshots
- /dashboard/order/snapshot-storage: https://www.coritan.com/dashboard/order/snapshot-storage

Snapshot storage is a service of its own that adds room to your account's snapshot allowance. It belongs to the account, so it covers the snapshots of every server you have, and it stays when a server is gone. Order it when your snapshots need more room than your server plans include, or to keep your snapshots after you cancel your last server.

## Before you begin

- Each storage service adds a fixed size to the allowance, up to 2 TB. Services add up, so order more than one for more room.
- For the first invoice, credit on your account pays first. Otherwise you pay by card or PayPal on the page the order lands on ([How the first payment works](/docs/get-started/order-a-service/#how-the-first-payment-works)).
- [How snapshot storage works](/docs/snapshots/storage-allowance/) explains what counts against the allowance.

## Order snapshot storage

Open the order page in one of these ways:

- In the [dashboard](https://www.coritan.com/dashboard/snapshots), go to **Snapshots** and select **Order more storage** at the top of the page.
- On a server's **Snapshots** tab, select **Order more storage** on the **Snapshot storage** card.
- When you take a snapshot that does not fit, select **Order more storage** in the **Not enough snapshot storage** alert.
- On [**Order a service**](https://www.coritan.com/dashboard/order), select the **Snapshot Storage** card under **Storage**.

The **Snapshot storage** card at the top of the page shows how much of your allowance is **Used** and how much is left, so you can see how much room you are short of.

1. Under **Size**, choose a tier. Each one says how much it adds to the allowance and what that costs per GB a month, such as `Adds 100 GB to the snapshot allowance on this account. 2.5¢/GB a month.`
2. Choose the billing cycle with the buttons beside the **Size** heading, such as **Monthly**. A longer term names what it saves, such as `Annually · save 20%`.
3. Check the summary under **Your order**. It lists the tier with its billing cycle, with **Change** beside it, and the **Total** with what is due today. The line under the total says how the first invoice is paid. On a phone the summary follows the tiers, and **Review order** at the bottom of the screen takes you to it.
4. Select the button under the summary. It reads **Place order and pay** when you pay after placing the order, and **Place order** when your credit pays for it or your account is billed in arrears.

If we refuse the order, **Could not place the order** appears above the button with the reason.

You can also buy a tier with a new Container Apps server: on the server's order page, turn on the **Snapshot Storage** card under **Add-ons** and choose its **Size** ([Order a server](/docs/managed-containers/order-a-server/)). It goes on the server's first invoice and becomes a storage service of its own.

## Pay for the order

Once you place the order, its own page opens. When its title is **Order placed, payment due**, pay under **Pay invoice** with account credit, a saved card or PayPal account, or a new card ([Pay and follow the order](/docs/get-started/order-a-service/#pay-and-follow-the-order)). We add the storage once the invoice is paid. To pay later, leave the page and pay the invoice under [Invoices](/docs/billing/invoices/).

**What you ordered** on the order's page shows the service's number, such as `#1042`. Note it: you need it to change or cancel the storage later.

## Result

We add the storage as soon as the service is set up. The order's page then reads **Your order is ready**, and its button opens the **Snapshots** page, where the **Snapshot storage** card shows the larger allowance. When the account was over its allowance and now fits, the **Over the allowance** alert goes away and we cancel the cleanup date.

The service renews each billing cycle until you cancel it. The **Services** page lists it with **Snapshot Storage** in the **Product** column.

## Change or cancel snapshot storage

Each size is a plan of its own, so you cannot resize a storage service. For more room, order another one. For less, cancel one.

Selecting a storage service on the **Services** page opens the **Snapshots** page, which has no billing controls. To reach the service's **Billing** tab, open `https://www.coritan.com/dashboard/services/<service number>/billing` in your browser, with the number from the order's page. There, **Change plan…** moves the service to another billing cycle, and **Cancel service…** cancels it ([Cancel a service](/docs/billing/cancel-a-service/)).

> [!WARNING]
> When a storage service ends, its room leaves the allowance. The cancel dialog says that the service's data is deleted, but ending the storage deletes no snapshot by itself. If your snapshots no longer fit, a grace period starts, and after it we delete the oldest snapshots until the rest fit ([When the account is over](/docs/snapshots/storage-allowance/#when-the-account-is-over)).

If a renewal invoice goes unpaid and we suspend the service, the account keeps the room until the service ends.

## Troubleshooting

`No Snapshot Storage plans yet`
: Snapshot storage is not in the catalogue for your account. [Contact support](/docs/support/conversations/) if you expected it.

**Could not load the plans**
: The tiers did not load. Select **Try again**, or reload the page.

**Could not load the snapshot allowance**
: The card at the top of the page could not read your allowance. Select **Try again** on it. You can still order a tier.

The button under the summary is greyed out
: The line under the button says why, such as `This plan has no price yet.` Select it to go to the **Size** section, and choose another tier.

The allowance has not grown
: We add the storage once the service is set up, which waits for the first invoice to be paid. Pay it from [Invoices](/docs/billing/invoices/).

**Over the allowance** still shows
: The new storage does not cover everything your snapshots take. Delete snapshots you no longer need ([Lock, download and delete snapshots](/docs/snapshots/manage-snapshots/#delete-a-snapshot)), or order more storage.

You need more than 2 TB in one service
: [Contact support](/docs/support/conversations/) about a larger amount, or order several storage services.

## Related

- [How snapshot storage works](/docs/snapshots/storage-allowance/)
- [Snapshots](/docs/snapshots/)
- [Order a service](/docs/get-started/order-a-service/)
- [Pay an invoice](/docs/billing/invoices/)
- [Cancel a service](/docs/billing/cancel-a-service/)

## With the API

Snapshot storage tiers are products whose `module_name` is `storage` in [`GET /products/`](/docs/api/reference/client/catalog/#op-get-api-v1-products). Order one with [`POST /services/order`](/docs/api/reference/client/services/#op-post-api-v1-services-order), as [Order a service](/docs/get-started/order-a-service/#with-the-api) describes. The size comes from the tier, so `config` can be empty. If you send `storage_gb`, it must match the tier's size.

```bash
curl -X POST https://api.coritan.com/api/v1/services/order \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": 41,
    "pricing_id": 118,
    "idempotency_key": "8d2f6a14-3c7e-4b9a-a1d5-6e0c9f2b7a38",
    "config": {"storage_gb": 100}
  }'
```

A `storage_gb` that does not match the tier answers `422` with `{"detail": {"errors": [...]}}`, such as `This plan is 50 GB of snapshot storage; to buy 100 GB choose the plan for that size`. A `storage_gb` that is not a whole number answers `storage_gb must be an integer`.

To buy a tier with a new server, put it in the server order's `addons`, as `{"product_id": 41}`. We take its price on the server's billing cycle, else its monthly price. A server order takes one Snapshot Storage add-on, and a `storage_gb` that does not match answers the same `422`, with the tier's name in front ([Add-ons in the order](/docs/get-started/order-a-service/#add-ons-in-the-order)).

`GET /api/v1/services/` lists the storage service with its `id`. Cancel it with `POST /api/v1/services/{service_ref}/cancel` ([Cancel a service](/docs/billing/cancel-a-service/#with-the-api)). `GET /api/v1/client/snapshots/allowance` shows the allowance it adds ([How snapshot storage works](/docs/snapshots/storage-allowance/#with-the-api)).

## API

- `POST /api/v1/services/order`: Order a platform service, and any add-ons bought with it (https://www.coritan.com/docs/api/reference/client/services/#op-post-api-v1-services-order)