---
title: "manage instance"
method: PUT
path: "/api/v0/instances/{id}/"
tags: ["Instances"]
---

# manage instance

`PUT /api/v0/instances/{id}/`

Manage instance state and labels. The operation is determined by the request body parameters.

CLI Usage:
- To stop: `vastai stop instance <id>`
- To start: `vastai start instance <id>`
- To label: `vastai label instance <id> <label>`

## Path parameters

- `id` integer, required

## Request body

- object — At least one of these parameters should be provided
  - `state` 'stopped' | 'running' — Change instance state (optional)
  - `label` string — Text label to assign to the instance (optional)

## Response `200`

Operation completed successfully

- SimpleBooleanSuccessResponse
  - `success` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `429` — Too Many Requests

---

[API](https://skmtc.net/vast/apis/vast-ai-api.md) · [All operations](https://skmtc.net/vast/apis/vast-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vast/vast-ai-api/revisions/4ed14f79f796/schema)