Instances

An instance is a virtual machine. A standard instance gets its own public IPv4 address and a security group. An instance created with a subnet_id lives in a VPC instead: it has a private address, and is reached through a public IP. A standard instance can also be given a second interface on its zone's private database network, to reach managed databases.

Every change is asynchronous. Creating one returns an order; every other change returns an operation to follow.

#The instance object

#List instances

Your instances, newest first, with addresses and state. Filter by name with q, or by state.

curl "https://api.pantechdynamics.com/public/v1/instances" \
  -H "Authorization: Bearer $PANTECH_API_KEY"

{
  "data": [
    {
      "id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
      "name": "web-1",
      "plan_id": "plan_06gk3x9tq7m2v8r4y1c5d0zp8w",
      "plan_slug": "starter",
      "image_id": "img_06gk3x9tq7m2v8r4y1c5d0zp8w",
      "image_slug": "ubuntu-24-04",
      "encrypted": true,
      "region": "af-abj",
      "zone": "af-abj-1",
      "network_id": null,
      "subnet_id": null,
      "security_group_id": "sg_06gk3x9tq7m2v8r4y1c5d0zp8w",
      "public_ipv4": "102.211.122.80",
      "private_ipv4": "10.0.1.12",
      "private_network_state": "attached",
      "deletion_protection": true,
      "private_network_ip": "10.250.4.23",
      "desired_state": "running",
      "observed_state": "running",
      "spec": {
        "vcpu": 2,
        "memory_mb": 4096,
        "disk_gb": 80
      },
      "tags": {
        "env": "production"
      },
      "failure": null,
      "created_at": "2026-10-03T09:30:00Z",
      "updated_at": "2026-10-03T09:30:00Z"
    }
  ],
  "next_cursor": "eyJhdCI6IjIwMjYtMTAtMDNUMDk6MzA6MDBaIiwiaWQiOiJ2bV8wNmdrIn0"
}

#Create an instance

Orders a new instance (VPS). Choose a plan (GET /public/v1/plans), an image (GET /public/v1/images) and an SSH key (GET /public/v1/ssh-keys), which is required: images have no password login.

Placement. Leave out subnet_id for a standard instance with its own public IPv4, protected by a security group (your organization's default group unless you send security_group_id). Send subnet_id (and optionally its network_id) to place it in a VPC subnet, with a private address only; reach it through a public IP.

Paid first. Returns 202 Accepted with an order (order_id, also the Location header). The initial payment is taken from credit, or else from the organization's default card, and then the instance is provisioned. Follow GET /public/v1/instance-orders/{order_id} until status is provisioned, then read the instance; payment_failed and failed are final, and any payment taken is returned to your credit.

Idempotency. Send an Idempotency-Key. A retry with the same key returns the original order instead of ordering a second instance.

curl -X POST "https://api.pantechdynamics.com/public/v1/instances" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "web-1",
    "plan_slug": "starter",
    "image_slug": "ubuntu-24-04",
    "ssh_key_id": "sshk_06gk3x9tq7m2v8r4y1c5d0zp8w"
  }'

{
  "order_id": "ord_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "instance_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "awaiting_payment",
  "operation_id": null,
  "failure_code": null,
  "amount_minor": 1059200,
  "currency": "NGN"
}

#Get an instance

One instance: its plan, image, addresses (including private_network_ip once a private database network interface is attached), and current state. A change is complete when observed_state matches desired_state.

curl "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w" \
  -H "Authorization: Bearer $PANTECH_API_KEY"

{
  "id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "name": "web-1",
  "plan_id": "plan_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "plan_slug": "starter",
  "image_id": "img_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "image_slug": "ubuntu-24-04",
  "encrypted": true,
  "region": "af-abj",
  "zone": "af-abj-1",
  "network_id": null,
  "subnet_id": null,
  "security_group_id": "sg_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "public_ipv4": "102.211.122.80",
  "private_ipv4": "10.0.1.12",
  "private_network_state": "attached",
  "deletion_protection": true,
  "private_network_ip": "10.250.4.23",
  "desired_state": "running",
  "observed_state": "running",
  "spec": {
    "vcpu": 2,
    "memory_mb": 4096,
    "disk_gb": 80
  },
  "tags": {
    "env": "production"
  },
  "failure": null,
  "created_at": "2026-10-03T09:30:00Z",
  "updated_at": "2026-10-03T09:30:00Z"
}

#Start an instance

Starts a stopped instance. A running instance is billed for its plan again.

Returns 202 Accepted with an operation_id (also in the Location header). The change happens in the background: poll GET /public/v1/operations/{operation_id}, or stream /events, until status is succeeded or failed; a failed operation carries a stable failure.code and a readable failure.reason.

Send an Idempotency-Key. A retry with the same key returns the original operation instead of making the change twice.

curl -X POST "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/start" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

{
  "operation_id": "op_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "resource_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "submitting"
}

#Stop an instance

Shuts the instance down. A stopped instance keeps its disks and addresses and is billed for storage only.

Returns 202 Accepted with an operation_id (also in the Location header). The change happens in the background: poll GET /public/v1/operations/{operation_id}, or stream /events, until status is succeeded or failed; a failed operation carries a stable failure.code and a readable failure.reason.

Send an Idempotency-Key. A retry with the same key returns the original operation instead of making the change twice.

For the first 5 minutes after a new instance is created, this returns 409 with code INSTANCE_POWER_LOCKED while first boot finishes. Wait the Retry-After header's seconds, then try again. Pending, provisioning, or uncertain instances also return this 409 before the first run is recorded, without Retry-After; wait for the instance to reach running first.

curl -X POST "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/stop" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

{
  "operation_id": "op_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "resource_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "submitting"
}

#Reboot an instance

Restarts the instance (a clean reboot of the operating system). It must be running.

Returns 202 Accepted with an operation_id (also in the Location header). The change happens in the background: poll GET /public/v1/operations/{operation_id}, or stream /events, until status is succeeded or failed; a failed operation carries a stable failure.code and a readable failure.reason.

Send an Idempotency-Key. A retry with the same key returns the original operation instead of making the change twice.

For the first 5 minutes after a new instance is created, this returns 409 with code INSTANCE_POWER_LOCKED while first boot finishes. Wait the Retry-After header's seconds, then try again. Pending, provisioning, or uncertain instances also return this 409 before the first run is recorded, without Retry-After; wait for the instance to reach running first.

curl -X POST "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/reboot" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

{
  "operation_id": "op_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "resource_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "submitting"
}

#Rename an instance

Changes the instance's name (1 to 255 characters, unique among your instances).

Returns 202 Accepted with an operation_id (also in the Location header). The change happens in the background: poll GET /public/v1/operations/{operation_id}, or stream /events, until status is succeeded or failed; a failed operation carries a stable failure.code and a readable failure.reason.

Send an Idempotency-Key. A retry with the same key returns the original operation instead of making the change twice.

curl -X POST "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/rename" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "web-2"
  }'

{
  "operation_id": "op_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "resource_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "submitting"
}

#Resize an instance

Moves the instance to a bigger plan. The instance is stopped, resized and started again. Instances only grow: the new plan must be bigger than the current one. No upfront charge: the bigger plan is billed hourly from the change.

Returns 202 Accepted with an operation_id (also in the Location header). The change happens in the background: poll GET /public/v1/operations/{operation_id}, or stream /events, until status is succeeded or failed; a failed operation carries a stable failure.code and a readable failure.reason.

Send an Idempotency-Key. A retry with the same key returns the original operation instead of making the change twice.

curl -X POST "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/resize" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_slug": "starter"
  }'

{
  "operation_id": "op_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "resource_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "submitting"
}

#Rebuild an instance

Reinstalls the operating system from image_slug, or from the instance's current image when it is left out. Everything on the root disk is erased; attached volumes, addresses and the plan are kept. Take a snapshot first if you may need the data.

Returns 202 Accepted with an operation_id (also in the Location header). The change happens in the background: poll GET /public/v1/operations/{operation_id}, or stream /events, until status is succeeded or failed; a failed operation carries a stable failure.code and a readable failure.reason.

Send an Idempotency-Key. A retry with the same key returns the original operation instead of making the change twice.

Scope: write. Destructive: an AI app's key also needs delete.

curl -X POST "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/rebuild" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "operation_id": "op_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "resource_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "submitting"
}

#Restore an instance from a snapshot

Rolls the instance's root disk back to one of its own snapshots and reboots it. Everything written to the root disk since the snapshot is lost, so confirm_name must repeat the instance's current name. Attached volumes are not changed.

Returns 202 Accepted with an operation_id (also in the Location header). The change happens in the background: poll GET /public/v1/operations/{operation_id}, or stream /events, until status is succeeded or failed; a failed operation carries a stable failure.code and a readable failure.reason.

Send an Idempotency-Key. A retry with the same key returns the original operation instead of making the change twice.

Scope: write. Destructive: an AI app's key also needs delete.

curl -X POST "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/restore" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "snapshot_id": "snap_06gk3x9tq7m2v8r4y1c5d0zp8w",
    "confirm_name": "web-1"
  }'

{
  "operation_id": "op_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "resource_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "submitting"
}

#Change an instance's SSH key

Replaces the SSH key you log in to the instance with by another key on your account, for example after losing the private key. The instance must be running: it is stopped, given the new key and started again, which takes about two minutes. The previous key stops working once the instance is back. Keys you added to the server yourself are left as they are.

Returns 202 Accepted with an operation_id (also in the Location header). The change happens in the background: poll GET /public/v1/operations/{operation_id}, or stream /events, until status is succeeded or failed; a failed operation carries a stable failure.code and a readable failure.reason.

Send an Idempotency-Key. A retry with the same key returns the original operation instead of making the change twice.

curl -X POST "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/change-ssh-key" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "ssh_key_id": "sshk_06gk3x9tq7m2v8r4y1c5d0zp8w"
  }'

{
  "operation_id": "op_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "resource_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "submitting"
}

#Change an instance's security group

Moves a standard instance to another of your security groups. The instance must be stopped; the new group applies when it starts again.

If the instance has a private database network interface, the new group must allow nothing from the private network's range (10.250.0.0/20 in af-abj-1): a group with any ingress rule whose source overlaps it, 0.0.0.0/0 included, is refused.

Returns 202 Accepted with an operation_id (also in the Location header). The change happens in the background: poll GET /public/v1/operations/{operation_id}, or stream /events, until status is succeeded or failed; a failed operation carries a stable failure.code and a readable failure.reason.

Send an Idempotency-Key. A retry with the same key returns the original operation instead of making the change twice.

curl -X PUT "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/security-group" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "security_group_id": "sg_06gk3x9tq7m2v8r4y1c5d0zp8w"
  }'

{
  "operation_id": "op_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "resource_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "submitting"
}

#Open the browser console

Returns a short-lived URL to the instance's browser console. The console gives a logged-in shell; treat the URL as a password and never log or share it. The instance must be running.

Idempotency: each request opens a new console URL; a retry is not replayed. Opening one changes nothing else, so retrying is safe.

curl -X POST "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/console" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

{
  "url": "https://x.serial-console.pantechdynamics.com/…"
}

#Issue a volume key credential

Gives an instance the credential it uses to ask Pantech for the key of an encrypted data volume. Put the credential on the instance, in the volume agent's configuration, and attach the volume to any instance of your organization: that instance can unlock the volume, whether it runs an encrypted image or a plain one. A volume's key is released only to an instance of the same organization that the volume is attached to.

The credential is a secret: it is shown once. Pantech keeps only a hash of it, so it cannot be shown again. Treat it like a password and never log or share it. Each request issues a new credential and ends the previous one for that instance, so use it to rotate a credential too, and update the agent on that instance. The credential also ends when the instance is deleted.

Idempotency: each request issues a new credential; a retry is not replayed.

curl -X POST "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/volume-key-credential" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

{
  "instance_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "credential": "credential"
}

#Grant temporary SSH access

Opens port 22 of a standard instance to the address this request comes from, for 15 minutes, so you can SSH in without leaving the port open. The instance must be running and be the only one using its security group.

Returns 202 Accepted with an operation_id (also in the Location header). The change happens in the background: poll GET /public/v1/operations/{operation_id}, or stream /events, until status is succeeded or failed; a failed operation carries a stable failure.code and a readable failure.reason. Then read the grant (GET /public/v1/instances/{instance_id}/ssh-access/{grant_id}, the operation's resource_id is the grant id) for the host and port to connect to once status is active.

Send an Idempotency-Key. A retry with the same key returns the original operation instead of making the change twice.

curl -X POST "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/ssh-access" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

{
  "operation_id": "op_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "resource_id": "sshg_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "submitting"
}

#Get an SSH access grant

A temporary SSH access grant: its status, and the host and port to connect to once it is active. It expires by itself at expires_at.

curl "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/ssh-access/sshg_06gk3x9tq7m2v8r4y1c5d0zp8w" \
  -H "Authorization: Bearer $PANTECH_API_KEY"

{
  "id": "sshg_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "instance_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "active",
  "host": "102.211.122.80",
  "port": 22,
  "expires_at": "2026-10-03T09:30:00Z",
  "revoked_at": "2026-10-03T09:30:00Z",
  "created_at": "2026-10-03T09:30:00Z"
}

#Revoke SSH access

Closes the port opened by a grant before it expires.

Returns 202 Accepted with an operation_id (also in the Location header). The change happens in the background: poll GET /public/v1/operations/{operation_id}, or stream /events, until status is succeeded or failed; a failed operation carries a stable failure.code and a readable failure.reason.

Send an Idempotency-Key. A retry with the same key returns the original operation instead of making the change twice.

Scope: write. Destructive: an AI app's key also needs delete.

curl -X DELETE "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/ssh-access/sshg_06gk3x9tq7m2v8r4y1c5d0zp8w" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

{
  "operation_id": "op_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "resource_id": "sshg_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "submitting"
}

#Delete an instance

Deletes the instance. It is stopped, a safety snapshot of its root disk is kept for 24 hours, and then it is removed. Attached volumes are detached, not deleted. Release its public IP and delete port forwarding rules that point at it first.

Returns 202 Accepted with an operation_id (also in the Location header). The change happens in the background: poll GET /public/v1/operations/{operation_id}, or stream /events, until status is succeeded or failed; a failed operation carries a stable failure.code and a readable failure.reason.

Send an Idempotency-Key. A retry with the same key returns the original operation instead of making the change twice.

Scope: write. Destructive: an AI app's key also needs delete.

curl -X DELETE "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

{
  "operation_id": "op_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "resource_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "submitting"
}

#Get instance metrics

CPU, memory, network and disk activity over interval (1h, 24h, 7d or 30d), one point per bucket. available is false when no samples exist yet, for example just after creation.

curl "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/metrics" \
  -H "Authorization: Bearer $PANTECH_API_KEY"

{
  "interval": "1h",
  "available": true,
  "sampled_at": "2026-10-03T09:30:00Z",
  "points": [
    {
      "bucket_start": "2026-10-03T09:30:00Z",
      "bucket_end": "2026-10-03T09:30:00Z",
      "cpu_percent": 1,
      "memory_percent": 1,
      "network_in_bytes": 1,
      "network_out_bytes": 1,
      "disk_read_peak_bytes_per_second": 1,
      "disk_write_peak_bytes_per_second": 1
    }
  ]
}

#Add a private database network interface to an instance

Adds a second network interface on the zone's private database network to a standard instance, so it can reach your managed databases there by their private address. Only in a zone with a private database network (af-abj-1); a VPC instance already reaches databases in its own VPC. The interface is free.

When the operation succeeds, the instance's private_network_state is attached and private_network_ip is the interface's address: allow it on each database as a /32 access rule (Replace access rules).

The instance's security group must allow nothing from the private network's range (10.250.0.0/20; the zone's private_network_cidr in GET /public/v1/regions). A security group applies to every interface of an instance, so any ingress rule whose source overlaps that range, whatever its protocol or ports, would let every database and every other customer's private interface on the network reach this instance. That includes 0.0.0.0/0 and 10.0.0.0/8, and the ICMP-from-anywhere rule of your organization's default security group. Such a group is refused, naming the rules to change: replace 0.0.0.0/0 with the addresses you actually need, or with ranges that leave out 10.250.0.0/20, or move the instance to a group without such rules. While the instance has the interface, rule changes and group moves that would allow the range are refused too.

The instance must be running or stopped with no other change in progress. A running instance gets the interface without a restart.

In the guest the interface stays down until you configure it. On Ubuntu add it to netplan with DHCP only, never the default route or DNS: dhcp4: true with dhcp4-overrides: {use-routes: false, use-dns: false} for the new interface (often ens4 or eth1), then run netplan apply.

Returns 202 Accepted with an operation_id (also in the Location header). The change happens in the background: poll GET /public/v1/operations/{operation_id}, or stream /events, until status is succeeded or failed; a failed operation carries a stable failure.code and a readable failure.reason. If the operation fails, its failure.code says why: SECURITY_GROUP_ALLOWS_PRIVATE_NETWORK (a rule allowing the range was added meanwhile; nothing was attached), INSTANCE_BUSY (the instance kept changing; retry when it has settled), or INSTANCE_PRIVATE_NETWORK_ATTACH_FAILED (retry later, or contact support). The instance itself is never marked failed for it.

Send an Idempotency-Key. A retry with the same key returns the original operation instead of making the change twice.

curl -X POST "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/private-network" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

{
  "operation_id": "op_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "resource_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "submitting"
}

#Remove an instance's private database network interface

Removes the instance's interface on the private database network. The instance must be running or stopped with no other change in progress; a running instance keeps running. private_network_ip stays readable until the operation succeeds; then remove any database access rule for it, and the interface from the guest's network configuration.

Returns 202 Accepted with an operation_id (also in the Location header). The change happens in the background: poll GET /public/v1/operations/{operation_id}, or stream /events, until status is succeeded or failed; a failed operation carries a stable failure.code and a readable failure.reason. A detach that cannot complete fails with INSTANCE_PRIVATE_NETWORK_DETACH_FAILED; retry later.

Send an Idempotency-Key. A retry with the same key returns the original operation instead of making the change twice.

Scope: write. Destructive: an AI app's key also needs delete.

curl -X DELETE "https://api.pantechdynamics.com/public/v1/instances/vm_06gk3x9tq7m2v8r4y1c5d0zp8w/private-network" \
  -H "Authorization: Bearer $PANTECH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

{
  "operation_id": "op_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "resource_id": "vm_06gk3x9tq7m2v8r4y1c5d0zp8w",
  "status": "submitting"
}