Skip to main content
POST
/
projects
/
{id}
/
disks
Create Disk
curl --request POST \
  --url https://api.mkinf.io/v0.1/projects/{id}/disks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "block_size": 4096,
  "location": "us-northcentral1-a",
  "name": "my-disk",
  "size": "10GiB",
  "type": "persistent-ssd"
}
'
{
  "operation": {
    "completed_at": "2021-12-03T19:59:34Z",
    "metadata": {},
    "operation_id": "F6EF489C-086E-458D-B812-7962964A28C9",
    "result": {},
    "started_at": "2021-12-03T19:58:34Z",
    "state": "IN_PROGRESS"
  }
}
Create a new disk in a project.

​
Required Parameters

  • name: Disk name
  • size: Size in GiB or TiB (e.g., “10GiB”)
  • location: Deployment location

​
Optional Parameters

  • block_size: Block size in bytes (512 or 4096)
  • type: Disk type (“persistent-ssd” or “shared-volume”)

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

Project id

Body

application/json
​
name
string
required

Disk name

​
size
string
required

Disk size in gibibytes (GiB) or tebibytes (TiB) in the format [Size][GiB|TiB]

​
location
string
required

Location

​
block_size
integer<int64>

Block size in bytes 512 or 4096

​
type
enum<string>
default:persistent-ssd

Disk type

Available options:
persistent-ssd,
shared-volume

Response

200 - application/json
​
operation
object
required