Get a machine

GET/machine/{id}

Authorization

AuthorizationAPI key · headerrequired

The Incoming Secret value (<secretId>.<random>), with or without a Bearer prefix.

Path parameters

idstringrequired

Responses

200

OK. A missing id returns 200 with an empty body — check for an id in the response.

idstring

Machine ID (autoassigned, read-only)

appIdstring

Application ID (autoassigned, read-only)

machineGroupIdstring

Machine group ID (create-only, not updatable)

customIdstring

Custom identifier

namestring

Machine name

isEnabledboolean

Whether the machine is enabled (read-only)

groupPropertiesobject

Machine group properties, Property Name to Value mapping (read-only)

propertiesobject

Object with Property Name to Value mapping

createdAtstring

Creation date (ISO date, autoassigned, read-only)

401

Authentication failed. All causes return this identical response.

codeinteger

messagestring

typestring

default

Downstream errors pass through verbatim; x-error-source names the failing service.

codeinteger

messagestring

typestring

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

API keyRemember on this deviceInclude my values in samples

Parameters

idpath*

Request

curl -X GET 'https://next.amfg.ai/engine-service/public-api/v1/machine/string' \
  -H 'Authorization: YOUR_API_KEY'

const response = await fetch("https://next.amfg.ai/engine-service/public-api/v1/machine/string", {
  method: "GET",
  headers: {
    "Authorization": "YOUR_API_KEY"
  }
});

import requests

response = requests.get(
    "https://next.amfg.ai/engine-service/public-api/v1/machine/string",
    headers={
        "Authorization": "YOUR_API_KEY"
    },
)

Response

{
  "id": "165",
  "machineGroupId": "246",
  "appId": "1677",
  "customId": "MG-0002-001",
  "name": "Machine 001",
  "isEnabled": true,
  "groupProperties": {
    "Custom Property": "Custom Value 5",
    "Property2": "value 5"
  },
  "properties": {
    "Property2": "Machine Property"
  },
  "createdAt": "2022-07-01T17:49:27.652Z"
}

{
  "code": 401,
  "message": "Not Authorized"
}

{
  "code": 0,
  "message": "string",
  "type": "string"
}