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

# Health Machines

`GET /v1/health/machines`

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.net/cyberdesk-hq/apis/cyberdesk-cloud.md) · [All operations](https://skmtc.net/cyberdesk-hq/apis/cyberdesk-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cyberdesk-hq/cyberdesk-cloud/revisions/830d2f48963d/schema)