Assign the reels of a machine

Additive, not a replacement: reels already on the machine but absent from the body keep their state. Setting assignedReelId to a different reel expires the one currently on the printer.

PUT/machine/{machineId}/reels

Authorization

AuthorizationAPI key · headerrequired

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

Path parameters

machineIdstringrequired

Request body

application/json

assignedReelIdinteger

Id of the reel to mount on the printer (state on_printer).

storageReelIdsinteger[]

Ids of the reels to move into the machine storage; they are appended after the reels already in storage.

Responses

200

OK.

Array of object

object

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

machineIdpath*

Bodyapplication/json

Request body

Request

curl -X PUT 'https://next.amfg.ai/engine-service/public-api/v1/machine/string/reels' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "assignedReelId": 0,
  "storageReelIds": [
    0
  ]
}'

const response = await fetch("https://next.amfg.ai/engine-service/public-api/v1/machine/string/reels", {
  method: "PUT",
  headers: {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: "{\n  \"assignedReelId\": 0,\n  \"storageReelIds\": [\n    0\n  ]\n}"
});

import requests

response = requests.put(
    "https://next.amfg.ai/engine-service/public-api/v1/machine/string/reels",
    headers={
        "Authorization": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    data="{\n  \"assignedReelId\": 0,\n  \"storageReelIds\": [\n    0\n  ]\n}",
)

Response

[
  {}
]

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

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