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
"obico-ml-api"
Detector backend, or the printer's error code for native detections.
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": "obico-ml-api",
    "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"
    }
  }
]