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

# Dedalus Machines API

> Raw HTTP contracts for Dedalus Machines.

Use this section when you need the exact request shape, response schema, or
interactive playground for the Dedalus Machines API. For workflow examples, use
the product guides.

## Wire contract

| Field       | Value                                                                                         |
| ----------- | --------------------------------------------------------------------------------------------- |
| Base URL    | `https://dcs.dedaluslabs.ai`                                                                  |
| Auth        | `Authorization: Bearer $DEDALUS_API_KEY`                                                      |
| Idempotency | Send `Idempotency-Key` on mutating requests. Reuse a key only when retrying the same request. |

## Workflow guides

<CardGroup cols={2}>
  <Card title="Lifecycle" icon="power" href="/dcs/dm/lifecycle">
    List, update, sleep, wake, watch, and delete machines.
  </Card>

  <Card title="Executions" icon="terminal" href="/dcs/dm/executions">
    Run non-interactive commands and poll for output.
  </Card>

  <Card title="SSH" icon="key-round" href="/dcs/dm/ssh">
    Open short-lived SSH access with strict host checking.
  </Card>

  <Card title="Terminals" icon="square-terminal" href="/dcs/dm/terminals">
    Stream interactive PTY sessions over WebSocket.
  </Card>
</CardGroup>

<Note>
  Endpoint pages in the sidebar are generated from the DCS OpenAPI spec. They
  are the source of truth for parameters, request bodies, response schemas, and
  playground requests.
</Note>