Skip to main content
PUT
Set service volume

Authorizations

Authorization
string
header
required

Session access JWT or an API token (insta_<prefix>_<secret>).

Path Parameters

projectId
string<uuid>
required
serviceId
string<uuid>
required

Body

application/json
mountPath
string

Compute only: container mount path chosen on attachment; defaults to /data. Omit to preserve an existing path; path changes apply on the next deploy.

sizeGib
integer

volume size in whole Gi — when a volume exists, must be ≥ its current size; omit to attach at the plan volume cap of the calling org (10Gi free / 50Gi paid by default, env-overridable per deployment) — or, when one exists, read it back unchanged

Required range: x >= 1

Response

Default Response

volume
object
required
cap
object
required
service
object

A project-level service (postgres | storage | compute | redis | mysql | mongodb).

changed
boolean
attached
boolean

true when this call attached a NEW volume (it mounts at mountPath on the next deploy); false/absent when it grew an existing one