---
title: "POST /instance/{id}"
method: POST
path: "/instance/{id}"
---

# POST /instance/{id}

`POST /instance/{id}`

## Query parameters

- `action` string[]
- `function` string
- `log` '*'
- `module-tag` string[]

## Request body

- object
  - `persist` boolean — For update action.
  - `tags` string[] — For update action.
  - `op` 'CONFIG_GET' | 'CONFIG_SET' | 'CONFIG_UNION' | 'CONFIG_COMPLEMENT' | 'READ_GLOBALS' | 'READ_MEMORY' | 'READ_STACK' — For debug action.
  - `config` object — For debug action.
    - `breakpoints` integer[]
  - `addr` integer — For debug action.
  - `size` integer — For debug action.

## Response `200`

Instance information (no query parameters, or action parameter
specified update), debug response (action parameter specified
debug), program output (action parameter specified io), or empty
response acknowledging other instance action.

- object
  - `instance` string
  - `module` string
  - `status` object
    - `state` 'RUNNING' | 'SUSPENDED' | 'HALTED' | 'TERMINATED' | 'KILLED'
    - `cause` 'UNREACHABLE' | 'CALL_STACK_EXHAUSTED' | 'MEMORY_ACCESS_OUT_OF_BOUNDS' | 'INDIRECT_CALL_INDEX_OUT_OF_BOUNDS' | 'INDIRECT_CALL_SIGNATURE_MISMATCH' | 'INTEGER_DIVIDE_BY_ZERO' | 'INTEGER_OVERFLOW' | 'BREAKPOINT' | 'ABI_DEFICIENCY' | 'ABI_VIOLATION' | 'INTERNAL'
    - `result` integer
    - `error` string
  - `transient` boolean
  - `debugging` boolean
  - `tags` string[]

## Other responses

- `201` — Snapshot was created.

---

[API](https://skmtc.dev/gate-computer/apis/gate-api.md) · [All operations](https://skmtc.dev/gate-computer/apis/gate-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gate-computer/gate-api/revisions/ed5375211e84/schema)