Machines

Get Machines

get

Returns a list of machines in your organization.

Autorisierungen

Bearer

AuthorizationstringErforderlich

Abfrageparameter

sitestring · uuid[] · max: 50 · nullableOptional

cursorstringOptional

Antworten

200

Successful Response

application/json

422

Validation Error

application/json

get/v2/machines

HTTPcURLJavaScriptPython

GET /api/v2/machines HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "site": "123e4567-e89b-12d3-a456-426614174000",
      "genesis_date": "2026-07-18"
    }
  ],
  "metadata": {
    "next_cursor": "text"
  }
}

Create Machine

post

Create a new machine.

Autorisierungen

Bearer

AuthorizationstringErforderlich

Body

application/json

namestring · min: 1Erforderlich

Name of your Machine. Can be changed later

Example: Extruder X

sitestring · uuidErforderlich

UUID of the site this machine belongs to

Antworten

201

Successful Response

application/json

uuidstring · uuidErforderlich

namestringErforderlich

sitestring · uuidErforderlich

genesis_datestring · dateErforderlich

422

Validation Error

application/json

post/v2/machines

HTTPcURLJavaScriptPython

POST /api/v2/machines HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "name": "Extruder X",
  "site": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "site": "123e4567-e89b-12d3-a456-426614174000",
  "genesis_date": "2026-07-18"
}

Get Machine

get

Returns details for a specific machine.

Autorisierungen

Bearer

AuthorizationstringErforderlich

Pfadparameter

uuidstring · uuidErforderlich

Antworten

200

Successful Response

application/json

uuidstring · uuidErforderlich

namestringErforderlich

sitestring · uuidErforderlich

genesis_datestring · dateErforderlich

422

Validation Error

application/json

get/v2/machines/{uuid}

HTTPcURLJavaScriptPython

GET /api/v2/machines/{uuid} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "site": "123e4567-e89b-12d3-a456-426614174000",
  "genesis_date": "2026-07-18"
}

Update Machine

patch

Update a machine.

Autorisierungen

Bearer

AuthorizationstringErforderlich

Pfadparameter

uuidstring · uuidErforderlich

Body

application/json

namestring · min: 1Optional

Name of your Machine. Can be changed later

Example: Extruder X

Antworten

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

patch/v2/machines/{uuid}

HTTPcURLJavaScriptPython

PATCH /api/v2/machines/{uuid} HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "name": "Extruder X"
}

Kein Inhalt

Delete Machine

delete

Delete a machine

Autorisierungen

Bearer

AuthorizationstringErforderlich

Pfadparameter

machine_uuidstring · uuidErforderlich

Antworten

204

Successful Response

Kein Inhalt

422

Validation Error

application/json

delete/v2/machines/{machine_uuid}

HTTPcURLJavaScriptPython

DELETE /api/v2/machines/{machine_uuid} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

Kein Inhalt

Productivity Metrics

post

Get productivity metrics for a specific machine over a set of datetime ranges.

Autorisierungen

Bearer

AuthorizationstringErforderlich

Pfadparameter

uuidstring · uuidErforderlich

Body

application/json

cursorstringOptional

Antworten

200

Successful Response

application/json

422

Validation Error

application/json

post/v2/machines/{uuid}/productivity-metrics

HTTPcURLJavaScriptPython

POST /api/v2/machines/{uuid}/productivity-metrics HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "datetime_ranges": [
    {
      "start": "2026-07-18T08:47:27.134Z",
      "end": "2026-07-18T08:47:27.134Z"
    }
  ],
  "cursor": "text"
}

{
  "data": [
    {
      "start": "2026-07-18T08:47:27.134Z",
      "end": "2026-07-18T08:47:27.134Z",
      "availability": {
        "score": 1,
        "time_loss": 1
      },
      "performance": {
        "score": 1,
        "time_loss": 1
      },
      "quality": {
        "score": 1,
        "time_loss": 1
      },
      "productivity": {
        "score": 1,
        "time_loss": 1
      },
      "quantity_scrap": {
        "unit": "text",
        "value": 1
      },
      "quantity_yield": {
        "unit": "text",
        "value": 1
      }
    }
  ],
  "metadata": {
    "next_cursor": "text"
  }
}