Printago API
GET
/v1/printer-throttle-groups
List Staggered Start groups
Query Parameters
name
optional
string
Filter on
name. A bare value is an exact match (name=value); use name.<operator>=value for the other operators (ne, gt, gte, lt, lte, contains, startsWith, endsWith, in, notIn, isNull; which ones a field accepts depends on its type). See Querying Data.
enabled
optional
string
Filter on
enabled. A bare value is an exact match (enabled=value); use enabled.<operator>=value for the other operators (ne, gt, gte, lt, lte, contains, startsWith, endsWith, in, notIn, isNull; which ones a field accepts depends on its type). See Querying Data.
maxConcurrentStarts
optional
string
Filter on
maxConcurrentStarts. A bare value is an exact match (maxConcurrentStarts=value); use maxConcurrentStarts.<operator>=value for the other operators (ne, gt, gte, lt, lte, contains, startsWith, endsWith, in, notIn, isNull; which ones a field accepts depends on its type). See Querying Data.
releaseConditions
optional
string
Filter on
releaseConditions. A bare value is an exact match (releaseConditions=value); use releaseConditions.<operator>=value for the other operators (ne, gt, gte, lt, lte, contains, startsWith, endsWith, in, notIn, isNull; which ones a field accepts depends on its type). See Querying Data.
fallbackTimeoutSeconds
optional
string
Filter on
fallbackTimeoutSeconds. A bare value is an exact match (fallbackTimeoutSeconds=value); use fallbackTimeoutSeconds.<operator>=value for the other operators (ne, gt, gte, lt, lte, contains, startsWith, endsWith, in, notIn, isNull; which ones a field accepts depends on its type). See Querying Data.
temperatureToleranceC
optional
string
Filter on
temperatureToleranceC. A bare value is an exact match (temperatureToleranceC=value); use temperatureToleranceC.<operator>=value for the other operators (ne, gt, gte, lt, lte, contains, startsWith, endsWith, in, notIn, isNull; which ones a field accepts depends on its type). See Querying Data.
id
optional
string
Filter by record ID. A bare value is an exact match; use
id.in=a,b,c for several (up to 100). See Querying Data.
storeId
optional
string
Filter by store ID. Results are always limited to the store your API key belongs to, so this is rarely useful. See Querying Data.
createdAt
optional
string
Filter by creation time. Pass an ISO 8601 timestamp with a comparison operator, e.g.
createdAt.gte=2025-01-01T00:00:00Z. See Querying Data.
updatedAt
optional
string
Filter by last-modified time. Pass an ISO 8601 timestamp with a comparison operator, e.g.
updatedAt.gt=2025-01-01T00:00:00Z to fetch what changed since a checkpoint. See Querying Data.
sort
optional
string
Comma-separated
field:direction pairs, applied in order, e.g. createdAt:desc,name:asc. Direction is asc (the default) or desc. At most 5 clauses; JSON and array fields cannot be sorted on. See Querying Data.
limit
optional
number
Maximum number of records to return, 1–1000. Defaults to 1000; larger values are capped at 1000. See Querying Data.
offset
optional
number
Number of matching records to skip before returning results. Combine with
limit to page through a list, and with meta=true to learn the total. See Querying Data.
fields
optional
string
Comma-separated list of fields to return, e.g.
id,name,updatedAt. Other fields are left out of each record. At most 50 fields. See Querying Data.
include
optional
string
Comma-separated related records to embed in each result, e.g.
linkedParts,linkedParts.part. At most 4 includes, each at most 2 levels deep; only the relations this endpoint supports are accepted, anything else is a 400. See Querying Data.
meta
optional
boolean
Set to
true to wrap the response as { data, meta }, where meta carries total, count, offset, limit, hasMore and executionTime. Without it the response is a bare array. See Querying Data.
hints
optional
boolean
Set to
true to add a hints array of suggested follow-up API calls to the response (aimed at AI agents). A list response is wrapped as { data, meta, hints }. See Querying Data.
Response Schema
PrinterThrottleGroup[] | SearchResponse
Variant 1PrinterThrottleGroup[]
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
datarequired
Record<string, any>[]
Array of matching entities
metarequired
object
Pagination and result metadata
countrequired
number
Number of records returned in this response
executionTimerequired
number
Query execution time in milliseconds
hasMorerequired
boolean
Whether there are more records available
limitrequired
number
Maximum number of records requested
offsetrequired
number
Number of records skipped
totalrequired
number
Total number of matching records (before pagination)
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"
}
]