POST
/
projects
/
{id}
/
disks
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
required

Project id

Body

application/json

Response

200 - application/json

The response is of type object.