Machines

Create a Machine

Creates a named Machine queue. Requires an owner or admin. Names are unique per Workspace, case-insensitively.

<sub>Scope: devices:write</sub>

post/v3/organizations/{orgId}/machines

Request

Base URL: https://api.reasonmachines.com
URL: https://api.reasonmachines.com/v3/organizations/{orgId}/machines
Auth: HTTP bearer

Request body

namestring required

Letters, digits and hyphens (1-63, no leading or trailing hyphen, not UUID-shaped). Case-insensitive; stored lowercase.

platform'linux' | 'macos'

When set, only workers reporting this OS can enroll into or serve the Machine.

Response

Created Machine.

Example response

{
  "machine": {
    "id": "22222222-2222-4222-8222-222222222222",
    "name": "build-box",
    "platform": "linux",
    "created_by": "33333333-3333-4333-8333-333333333333",
    "created_at": "2026-09-26T09:00:00Z",
    "updated_at": "2026-09-26T09:00:00Z",
    "workers": {
      "total": 2,
      "online": 2,
      "busy": 1,
      "idle": 1
    },
    "sessions": {
      "queued": 3,
      "running": 1
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.