Skip to content
Public API
Esc
↑↓navigate↵open⌘Jpreview

Get a machine group

GET/machine-group/{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 group ID (autoassigned, read-only)

appIdstring

Application ID (autoassigned, read-only)

customIdstring

Custom identifier

namestring

Machine group name

descriptionstring

Machine group description

machineGroupSidstring

Machine group SID (autoassigned on create, read-only)

sizeobject

Service job size, object with numeric fields x, y, z

technologyIdstring

Technology ID

materialIdsany[]

Array of material IDs (read-only)

customFieldsany[]

Array of objects with id, label, value

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
Authorization
Parameters
Request
curl -X GET 'https://next.amfg.ai/engine-service/public-api/v1/machine-group/string' \
  -H 'Authorization: YOUR_API_KEY'
Response
{
  "id": "244",
  "appId": "1677",
  "customId": "MG-0001",
  "name": "PERFACTORY P4K",
  "description": "Machine group description",
  "machineGroupSid": "X-109-MACHINE-GROUP-95000",
  "size": {
    "x": 160,
    "y": 100,
    "z": 230
  },
  "technologyId": "276",
  "materialIds": [
    "384"
  ],
  "customFields": [
    {
      "id": 1,
      "label": "",
      "value": ""
    },
    {
      "id": 2,
      "label": "",
      "value": ""
    },
    {
      "id": 3,
      "label": "",
      "value": ""
    },
    {
      "id": 4,
      "label": "",
      "value": ""
    },
    {
      "id": 5,
      "label": "",
      "value": ""
    }
  ],
  "properties": {
    "Custom Property": "Custom Value",
    "Property2": "value 2"
  },
  "createdAt": "2022-07-04T05:56:55.969Z"
}