Snapshot Instance

POST 
/api/instance/:instance_id/snapshot

Create a visible snapshot. The deployed route defaults to synchronous saves for omitted, null or empty bodies; sync=false retains the existing asynchronous contract. Singular and plural instance routes are aliases.

Request

Responses

200

Successful Response

400

Malformed input or invalid operation parameters

401

Missing or invalid authentication

402

Billing or account restriction

403

Authorization or quota refusal

404

Instance not found in the authorized scope

409

Instance is not READY/running or has no assigned host

500

Database or operation failure

503

Snapshot admission busy, or an operation dependency unavailable. A typed no-dispatch admission refusal includes Retry-After: 1.

Response Headers

• Retry-After string

  Present only when snapshot admission was refused before dispatch; other 503 failures may omit it.