---
title: "Health Machines"
method: GET
path: "/v1/health/machines"
tags: ["health"]
---

# Health Machines

`GET /v1/health/machines`

## Request

- Base URL: `https://api.cyberdesk.io`
- URL: `https://api.cyberdesk.io/v1/health/machines`
- Auth: HTTP bearer

Probe the dimensions endpoint for all connected machines in scope.

Scope rules:
- Standard keys/JWT: only machines in the authenticated organization
- Cyberdesk root API key: machines across all organizations

## Response `200`

Successful Response

- MachinesHealthCheckResponse
  - `status` 'ok' | 'error', required
  - `scope` 'organization' | 'all_organizations', required
  - `checked_machines` integer, required
  - `healthy_machines` integer, required
  - `errored_machines` MachineHealthCheckError[], required
    - `machine_id` string, required
    - `organization_id` string, nullable
    - `machine_name` string, nullable
    - `status_code` integer, nullable
    - `error` string, required
  - `message` string, required

## Other responses

- `503`: One or more connected machines failed dimensions health probes

---

[API](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud.md) - [All operations](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/revisions/5579352ae05e?raw)