Update a machine group

Whole-record update — a partial body is rejected. The build volume is required, as either size or the three size* fields.

PUT/machine-group/{id}

Authorization

AuthorizationAPI key · headerrequired

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

Path parameters

idstringrequired

Request body

application/json

namestringrequired

Machine group name.

descriptionstringrequired

Description.

propertiesobjectrequired

Machine group properties.

technologyIdintegerrequired

Id of the technology.

sizeobject

Build volume, e.g. {"x": 100, "y": 100, "z": 100}. Equivalent to sending sizeX/sizeY/sizeZ.

sizeXnumber

Build volume X. Alternative to size.

sizeYnumber

Build volume Y. Alternative to size.

sizeZnumber

Build volume Z. Alternative to size.

customIdstring

Custom id. Kept unchanged when omitted.

customFieldsobject[]

Custom fields as [{"id": 1, "label": "...", "value": "..."}] (up to 5). Kept unchanged when omitted; sending the field replaces the whole list.

Responses

200

OK. Returns only the id — fetch the full Machine Group with the corresponding GET.

idinteger | stringrequired

Id of the updated Machine Group.

Show properties

One of:

integer

integer

string

string

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*

Bodyapplication/json

Request body

Request

curl -X PUT 'https://next.amfg.ai/engine-service/public-api/v1/machine-group/string' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "description": "string",
  "properties": {},
  "technologyId": 0,
  "size": {},
  "sizeX": 0,
  "sizeY": 0,
  "sizeZ": 0,
  "customId": "string",
  "customFields": [
    {}
  ]
}'

const response = await fetch("https://next.amfg.ai/engine-service/public-api/v1/machine-group/string", {
  method: "PUT",
  headers: {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"string\",\n  \"description\": \"string\",\n  \"properties\": {},\n  \"technologyId\": 0,\n  \"size\": {},\n  \"sizeX\": 0,\n  \"sizeY\": 0,\n  \"sizeZ\": 0,\n  \"customId\": \"string\",\n  \"customFields\": [\n    {}\n  ]\n}"
});

import requests

response = requests.put(
    "https://next.amfg.ai/engine-service/public-api/v1/machine-group/string",
    headers={
        "Authorization": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"string\",\n  \"description\": \"string\",\n  \"properties\": {},\n  \"technologyId\": 0,\n  \"size\": {},\n  \"sizeX\": 0,\n  \"sizeY\": 0,\n  \"sizeZ\": 0,\n  \"customId\": \"string\",\n  \"customFields\": [\n    {}\n  ]\n}",
)

Response

{
  "id": 0
}

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

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