Pause Instance

POST 
/api/instance/:instance_id/pause

Pause the instance using a synchronous snapshot. The snapshot query controls visibility: false or omitted is hidden; true is visible. A snapshot is created in either case. Already paused instances return unchanged. 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

An unresolved pause identity conflicts with this request.

412

Instance readiness or paused-state precondition failed

500

Database or operation failure

502

Original SAVE/Stop completion is not proven; retained evidence requires reconciliation.

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.