Skip to main content
POST
Create volume

Authorizations

Authorization
string
header
required

Your AI Reserve API key (aireserve_api_…) from the API Keys page in the portal (https://portal.aireserve.com/keys).

Headers

Idempotency-Key
string
required

Body

application/json
name
string
required
Maximum string length: 120
dataCenterId
string
required

Data center for the volume. Must match any pod you intend to attach it to.

sizeGb
integer
required

Initial size in GiB. Growth-only after creation.

Required range: 10 <= x <= 4096
quoteId
string
required

Signed quote token from POST /v1/gpu/quotes with kind: volume.

storageBillingAcknowledged
enum<boolean>
required

Must be true. Confirms you understand that storage billing accrues continuously while the volume exists.

Available options:
true

Response

Volume creation accepted.

Response to a 202 Accepted Compute mutation. All fields are camelCase. Use operationId to poll GET /v1/gpu/operations/{id} for terminal status.

accepted
enum<boolean>
required
Available options:
true
resourceId
string<uuid>
required

ID of the resource created or mutated.

operationId
string<uuid>
required

ID for the durable operation record. Poll GET /v1/gpu/operations/{id} for terminal status.

status
enum<string>
required
Available options:
accepted,
pending
resourceType
enum<string>
Available options:
pod,
volume,
template,
registry,
ssh_key