Printago API
GET /v1/ai-detection/alerts

List AI failure alerts

Requires: printer.view

Query Parameters

printerId optional
string
Only alerts for this printer.
printJobId optional
string
Only alerts for this print job.
limit optional
number
Max alerts to return; defaults to 20, capped at 100.

Response Schema

AiDetectionAlert[]
Array of AiDetectionAlert, each with:
attemptNumberrequirednullable
number
autoActionrequirednullable
"notify" | "stop" | "pause"
notifystoppause
autoActionStatusrequirednullable
"failed" | "not-applicable" | "sent"
failednot-applicablesent
coderequirednullable
string
createdAtrequired
string
detectorProviderrequirednullable
"printago-hosted" | "obico-ml-api"
Detector backend, or the printer's error code for native detections.
printago-hostedobico-ml-api
expectedThumbnailUrirequirednullable
string
Expected plate render for the linked job, when one exists.
feedbackrequirednullable
object
commentrequirednullable
string
createdAtrequired
string
idrequired
string
pattern: ^[a-z0-9]{24}$
printerEventIdrequired
string
pattern: ^[a-z0-9]{24}$
sourcerequired
"user" | "fuse"
userfuse
updatedAtrequired
string
userIdrequirednullable
string
verdictrequired
"true_positive" | "false_positive"
true_positivefalse_positive
framesrequired
object[]
capturedAtrequired
number
keyrequired
"now" | "t-10m" | "t-1m"
nowt-10mt-1m
layerrequirednullable
number
offsetMsrequired
number
percentrequirednullable
number
urlrequirednullable
string
Signed read URL; null when the frame never uploaded or has aged out.
fuseFeedbackrequirednullable
object
Fuse-originated label (auto-pause resumed or abandoned), when any.
commentrequirednullable
string
createdAtrequired
string
idrequired
string
pattern: ^[a-z0-9]{24}$
printerEventIdrequired
string
pattern: ^[a-z0-9]{24}$
sourcerequired
"user" | "fuse"
userfuse
updatedAtrequired
string
userIdrequirednullable
string
verdictrequired
"true_positive" | "false_positive"
true_positivefalse_positive
idrequired
string
pattern: ^[a-z0-9]{24}$
messagerequired
string
printerIdrequirednullable
string
pattern: ^[a-z0-9]{24}$
printJobIdrequirednullable
string
pattern: ^[a-z0-9]{24}$
smoothedScorerequirednullable
number
sourcerequired
"printer" | "detector"
printerdetector

Example Response

200 OK — application/json 
[
  {
    "id": "string",
    "createdAt": "string",
    "printerId": "string",
    "printJobId": "string",
    "attemptNumber": 1,
    "source": "printer",
    "detectorProvider": "printago-hosted",
    "code": "string",
    "message": "string",
    "smoothedScore": 1,
    "autoAction": "notify",
    "autoActionStatus": "failed",
    "frames": [
      {
        "key": "now",
        "capturedAt": 1,
        "offsetMs": 1,
        "layer": 1,
        "percent": 1,
        "url": "string"
      }
    ],
    "expectedThumbnailUri": "string",
    "feedback": {
      "id": "string",
      "printerEventId": "string",
      "verdict": "true_positive",
      "source": "user",
      "comment": "string",
      "userId": "string",
      "createdAt": "string",
      "updatedAt": "string"
    },
    "fuseFeedback": {
      "id": "string",
      "printerEventId": "string",
      "verdict": "true_positive",
      "source": "user",
      "comment": "string",
      "userId": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  }
]