Update a reel

The id goes in the body and must be numeric. At least one other field is required, otherwise the call fails with 400.

PUT/reel

Authorization

AuthorizationAPI key · headerrequired

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

Request body

application/json

idintegerrequired

Id of the reel (numeric, not a string).

statestring

Reel state.

Allowed:unassignedon_printerstorageexpired

batchIdstring

Batch label; unique among the app's non-expired reels.

machineIdinteger

Id of the machine the reel is on.

materialIdinteger

Id of the material.

colorIdinteger

Id of the colour.

machineSlotIdxinteger

Storage slot index on the machine.

amountOriginalnumber

Amount a full reel holds.

amountActualnumber

Amount currently left.

Responses

200

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

idinteger | stringrequired

Id of the updated ReelItem.

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

Bodyapplication/json

idinteger*Id of the reel (numeric, not a string).statestringReel state.batchIdstringBatch label; unique among the app's non-expired reels.machineIdintegerId of the machine the reel is on.materialIdintegerId of the material.colorIdintegerId of the colour.machineSlotIdxintegerStorage slot index on the machine.amountOriginalnumberAmount a full reel holds.amountActualnumberAmount currently left.

Request

curl -X PUT 'https://next.amfg.ai/engine-service/public-api/v1/reel' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": 0,
  "state": "unassigned",
  "batchId": "string",
  "machineId": 0,
  "materialId": 0,
  "colorId": 0,
  "machineSlotIdx": 0,
  "amountOriginal": 0,
  "amountActual": 0
}'

const response = await fetch("https://next.amfg.ai/engine-service/public-api/v1/reel", {
  method: "PUT",
  headers: {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: "{\n  \"id\": 0,\n  \"state\": \"unassigned\",\n  \"batchId\": \"string\",\n  \"machineId\": 0,\n  \"materialId\": 0,\n  \"colorId\": 0,\n  \"machineSlotIdx\": 0,\n  \"amountOriginal\": 0,\n  \"amountActual\": 0\n}"
});

import requests

response = requests.put(
    "https://next.amfg.ai/engine-service/public-api/v1/reel",
    headers={
        "Authorization": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    data="{\n  \"id\": 0,\n  \"state\": \"unassigned\",\n  \"batchId\": \"string\",\n  \"machineId\": 0,\n  \"materialId\": 0,\n  \"colorId\": 0,\n  \"machineSlotIdx\": 0,\n  \"amountOriginal\": 0,\n  \"amountActual\": 0\n}",
)

Response

{
  "id": 0
}

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

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