> ## 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.

# Start Workspace

> Start a stopped workspace

Starts a workspace that is currently stopped. The workspace will transition through the `starting` status before reaching `running`.

## 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": "starting"
  }
  ```
</ResponseExample>

## Errors

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