Skip to main content
PATCH
Update service

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
name
string

new service name (lower-kebab, max 39); applied last so the other fields in this request still address the service by its current name

Maximum string length: 256
alwaysOn
boolean

true = machines never autostop (the platform default for new compute services); false = scale-to-zero

memoryMb
integer

memory ceiling in MB — a multiple of 256, within the per-vCPU band

cpu
integer

vCPU ceiling; requires memoryMb, derived from it when omitted

startCommand
string

Compute runtime startup override via sh -c, including source-built images; overrides the built image CMD on next deploy or restart. Empty resets to image default. Persisted as readable service settings; use secrets for credentials.

Maximum string length: 8192
volumeMountPath
string

Compute only: container mount path chosen on attachment; defaults to /data. Requires volumeGib only when attaching. Existing path changes are staged until the next deploy.

volumeGib
integer

the persistent volume size in whole Gi — attaches when none exists, grows an existing one (never shrinks)

Response

Default Response

applied
string[]
required

the fields that actually changed: name, alwaysOn, limits, volume, volumeMountPath, startCommand

service
object

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

limits
object
cap
object
volume
object
volumeAttached
boolean

true when this patch attached the volume (it mounts on the next deploy)