---
title: "Creates a disk in the project and returns the async operation."
method: POST
path: "/projects/{project_id}/storage/disks"
tags: ["Disks"]
---

# Creates a disk in the project and returns the async operation.

`POST /projects/{project_id}/storage/disks`

Requires either a disk snapshot ID, or size and location, where size of disk
should be in gibibytes (GiB) or tebibytes (TiB) in the format [Size][Unit].
E.g. 10GiB. Disk type must be one of: DISK_TYPE_PERSISTENT_SSD.
A successful response from this resource will contain the async operation.

## Path parameters

- `project_id` string, required

## Request body

- DisksPostRequestV1
  - `block_size` integer — Block size for the new disk, in bytes: 512 or 4096.
  - `location` string — Location to create the disk in.
  - `name` string, required — Name for the new disk.
  - `size` string — Storage capacity for the new disk, given as a size and unit in the format [Size][Unit], for example 100GiB or 1TiB.
  - `snapshot_id` string — ID of a disk snapshot to create the disk from.
  - `type` 'persistent-ssd' | 'shared-volume' — Type of disk to create: persistent-ssd or shared-volume. Defaults to persistent-ssd.

## Response `200`

- AsyncOperationResponse
  - `operation` Operation, required — Individual resources that use Operations should populate the `metadata` field with resource-specific information.
    - `completed_at` string, required
    - `metadata` string, required
    - `operation_id` string, required
    - `result` string
    - `started_at` string, required
    - `state` 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED', required

## Other responses

- `400` — Error Bad Request
- `401` — Error Authentication Failed
- `403` — Error Permissions
- `500` — Error Internal Server

---

[API](https://skmtc.net/crusoecloud/apis/crusoe-cloud-api-gateway.md) · [All operations](https://skmtc.net/crusoecloud/apis/crusoe-cloud-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crusoecloud/crusoe-cloud-api-gateway/versions/a3fd2dedc72b/schema)