> For the complete documentation index, see [llms.txt](https://docs.nebulablock.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nebulablock.com/api-reference/platform-api/list-products/stop-instance.md).

# Stop Instance

Power off a running Nebula Block instance. Billing continues while the instance exists.

Shut down an instance. Provide the instance ID in the path to initiate the shutdown process for that instance.

## HTTP Request

`GET` `{API_URL}/computing/instance/{id}/stop`

## Path parameters

| Parameters | Requirements | Type     | Description                                                                                                               |
| ---------- | ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| id         | Required     | `string` | The unique identifier of the instance, from [List Instances](/api-reference/platform-api/list-products/list-instances.md) |

> **Note:** An unknown id is rejected with **HTTP 404** `Instance not found`, and an instance belonging to someone else with **HTTP 403** `Permission denied`. Those are the only real HTTP errors here — every other failure below comes back as HTTP 200.

> **Important:** The instance must be in `Running` state. Calling this on an instance in any other state returns **HTTP 200** with `"status": "failed"` and the message `"Instance status is invalid for stop operation"` — check `status`, not the HTTP code.

> **Note:** Not every configuration supports power actions — older ones in particular may not. Where the action is unavailable the call returns **HTTP 200** with `"status": "failed"` and the message `"Stopping instance failed"`, and the instance is left untouched. There is no capability flag to check in advance, so handle that message; if a stop fails this way on an instance you expect to support it, contact support.

## Response Attributes

#### data `list`

Always empty on this endpoint.

#### message `string`

A description of the status of the request.

#### status `string`

Indicates the result of the request. `success` signifies success, while `failed` indicates an error.

## Example

#### Request

```bash
curl -X GET '{API_URL}/computing/instance/{id}/stop' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \

```

#### Response

```json
{
    "message": "Instance stopped successfully",
    "status": "success"
}
```