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

# Machines

> List and manage machines with baselines

## List Machines

`GET /v1/machines`

Returns all machines with active baselines for the authenticated organization.

<ResponseField name="machines" type="array">
  Array of machine records, each containing machine metadata and baseline info.
</ResponseField>

<ResponseField name="total" type="integer">
  Total number of machines.
</ResponseField>

<RequestExample>
  ```bash List Machines theme={null}
  curl https://api.canaryedge.com/v1/machines \
    -H "X-Canary-Key: YOUR_API_KEY"
  ```

  ```bash Delete Machine theme={null}
  curl -X DELETE https://api.canaryedge.com/v1/machines/pump-47 \
    -H "X-Canary-Key: YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "machines": [
      {
        "machine_id": "pump-47",
        "baseline_created_at": "2026-03-30T12:00:00Z",
        "num_windows": 1984
      },
      {
        "machine_id": "compressor-12",
        "baseline_created_at": "2026-03-28T08:30:00Z",
        "num_windows": 4096
      }
    ],
    "total": 2
  }
  ```
</ResponseExample>

***

## Delete Machine

`DELETE /v1/machines/{machine_id}`

Remove a machine and its baseline data. Future detection requests for this machine will use the generic model instead of a fine-tuned predictor.

### Path Parameters

| Parameter    | Type   | Description                      |
| ------------ | ------ | -------------------------------- |
| `machine_id` | string | The machine identifier to delete |

### Response

```json theme={null}
{
  "machine_id": "pump-47",
  "deleted": true,
  "baseline_deleted": true
}
```