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

List machine groups

List filters are passed as query parameters — see the conventions in the introduction.

GET/machine-group
Authorization
AuthorizationAPI key · headerrequired

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

Responses
200

OK.

Array of MachineGroup
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
Request
curl -X GET 'https://next.amfg.ai/engine-service/public-api/v1/machine-group' \
  -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"
  }
]