> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Stop Workspace

> Stop a running workspace

Stops a running workspace. The workspace will transition through the `stopping` status before reaching `stopped`. The workspace volume is preserved.

## Authentication

Requires a valid Bearer token.

## Path Parameters

<ParamField path="id" type="string" required>
  Workspace ID (UUID).
</ParamField>

## Response

<ResponseField name="status" type="string" required>
  The new workspace status.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "status": "stopping"
  }
  ```
</ResponseExample>

## Errors

| Status | Description                                                    |
| ------ | -------------------------------------------------------------- |
| `400`  | Bad Request — workspace is not in a stoppable state            |
| `401`  | Unauthorized — missing or invalid token                        |
| `404`  | Not Found — workspace does not exist or you do not have access |