Printago API
PATCH /v1/printer-throttle-groups/{id}

Update Staggered Start group

Requires: printer.edit

Path Parameters

id required
string
The staggered start group ID

Request Body

PartialPickPrinterThrottleGroupnameenabledmaxConcurrentStartsreleaseConditionsfallbackTimeoutSecondstemperatureToleranceC
enabledoptional
boolean
fallbackTimeoutSecondsoptional
number
maxConcurrentStartsoptional
number
nameoptional
string
releaseConditionsoptional
object
bedoptionalnullable
object
moderequired
"percent-of-target" | "fixed-temp" | "first-layer-temp"
percent-of-targetfixed-tempfirst-layer-temp
percentoptionalnullable
number
temperatureCoptionalnullable
number
durationoptionalnullable
object
secondsrequired
number
nozzleoptionalnullable
object
moderequired
"percent-of-target" | "fixed-temp" | "first-layer-temp"
percent-of-targetfixed-tempfirst-layer-temp
percentoptionalnullable
number
temperatureCoptionalnullable
number
temperatureToleranceCoptional
number

Example Request

application/json
{
  "name": "string",
  "enabled": true,
  "maxConcurrentStarts": 1,
  "releaseConditions": {
    "bed": {
      "mode": "percent-of-target",
      "percent": 1,
      "temperatureC": 1
    },
    "nozzle": {
      "mode": "percent-of-target",
      "percent": 1,
      "temperatureC": 1
    },
    "duration": {
      "seconds": 1
    }
  },
  "fallbackTimeoutSeconds": 1,
  "temperatureToleranceC": 1
}

Response Schema

PrinterThrottleGroup
createdAtrequired
string
format: date-time
enabledrequired
boolean
fallbackTimeoutSecondsrequired
number
idrequired
string
pattern: ^[a-z0-9]{24}$
maxConcurrentStartsrequired
number
namerequired
string
releaseConditionsrequired
object
bedoptionalnullable
object
moderequired
"percent-of-target" | "fixed-temp" | "first-layer-temp"
percent-of-targetfixed-tempfirst-layer-temp
percentoptionalnullable
number
temperatureCoptionalnullable
number
durationoptionalnullable
object
secondsrequired
number
nozzleoptionalnullable
object
moderequired
"percent-of-target" | "fixed-temp" | "first-layer-temp"
percent-of-targetfixed-tempfirst-layer-temp
percentoptionalnullable
number
temperatureCoptionalnullable
number
storeIdrequired
string
pattern: ^[a-z0-9]{24}$
temperatureToleranceCrequired
number
updatedAtrequired
string
format: date-time

Example Response

200 OK — application/json
{
  "name": "string",
  "enabled": true,
  "maxConcurrentStarts": 1,
  "releaseConditions": {
    "bed": {
      "mode": "percent-of-target",
      "percent": 1,
      "temperatureC": 1
    },
    "nozzle": {
      "mode": "percent-of-target",
      "percent": 1,
      "temperatureC": 1
    },
    "duration": {
      "seconds": 1
    }
  },
  "fallbackTimeoutSeconds": 1,
  "temperatureToleranceC": 1,
  "id": "string",
  "storeId": "string",
  "createdAt": "2025-01-15T12:00:00.000Z",
  "updatedAt": "2025-01-15T12:00:00.000Z"
}