Skip to main content

API Endpoints

This page lists the major API endpoint groups in O.D.I.N. For full parameter details, response schemas, and "Try it out" functionality, use the interactive Swagger UI at /api/v1/docs on your running instance.

Printers​

MethodEndpointDescriptionRole
GET/api/v1/printersList all printersviewer+
POST/api/v1/printersAdd a printeroperator+
GET/api/v1/printers/{id}Get printer detailsviewer+
PUT/api/v1/printers/{id}Update printeroperator+
DELETE/api/v1/printers/{id}Delete printeradmin
POST/api/v1/printers/{id}/pausePause active printoperator+
POST/api/v1/printers/{id}/resumeResume paused printoperator+
POST/api/v1/printers/{id}/stopStop/cancel printoperator+
POST/api/v1/printers/{id}/fanSet fan speedsoperator+
POST/api/v1/printers/{id}/speedSet print speedoperator+
POST/api/v1/printers/{id}/lightToggle chamber lightoperator+
POST/api/v1/printers/{id}/plate-clearedConfirm plate clearedoperator+
POST/api/v1/printers/{id}/clear-errorsClear HMS errorsoperator+

Jobs​

MethodEndpointDescriptionRole
GET/api/v1/jobsList jobsviewer+
POST/api/v1/jobsCreate a joboperator+
GET/api/v1/jobs/{id}Get job detailsviewer+
PUT/api/v1/jobs/{id}Update joboperator+
DELETE/api/v1/jobs/{id}Delete jobadmin
POST/api/v1/jobs/batchBatch send to multiple printersoperator+
POST/api/v1/jobs/{id}/cloneClone/reprint joboperator+
GET/api/v1/jobs/filament-checkCheck filament compatibilityviewer+

Models​

MethodEndpointDescriptionRole
GET/api/v1/modelsList modelsviewer+
POST/api/v1/modelsUpload model (.3mf/.gcode)operator+
GET/api/v1/models/{id}Get model detailsviewer+
PUT/api/v1/models/{id}Update model metadataoperator+
DELETE/api/v1/models/{id}Delete modeladmin
GET/api/v1/models/{id}/variantsList model variants (plate_count, filament)viewer+

Archives​

MethodEndpointDescriptionRole
GET/api/v1/archivesList archives (paginated, filterable)viewer+
GET/api/v1/archives/{id}Get archive detailsviewer+
PATCH/api/v1/archives/{id}Update archive notes/tagsoperator+
DELETE/api/v1/archives/{id}Delete archiveadmin
POST/api/v1/archives/{id}/reprintReprint from archiveoperator+
GET/api/v1/archives/logPrint log (dense table, CSV export)viewer+
GET/api/v1/archives/compareCompare two archivesviewer+
GET/api/v1/archives/tagsList all tagsviewer+

Spools​

MethodEndpointDescriptionRole
GET/api/v1/spoolsList spoolsviewer+
POST/api/v1/spoolsCreate spooloperator+
PUT/api/v1/spools/{id}Update spooloperator+
DELETE/api/v1/spools/{id}Delete spooladmin
GET/api/v1/spools/low-stockLow-stock spoolsviewer+
GET/api/v1/spools/exportCSV exportviewer+
GET/api/v1/spools/{id}/labelGenerate QR labelviewer+

Projects​

MethodEndpointDescriptionRole
GET/api/v1/projectsList projectsviewer+
POST/api/v1/projectsCreate projectoperator+
GET/api/v1/projects/{id}Get project detailsviewer+
PUT/api/v1/projects/{id}Update projectoperator+
DELETE/api/v1/projects/{id}Delete projectadmin
POST/api/v1/projects/{id}/archivesAssign archivesoperator+

Authentication​

MethodEndpointDescriptionRole
POST/api/v1/auth/loginLogin (returns session cookie)public
POST/api/v1/auth/logoutLogout (revokes session)any
GET/api/v1/auth/meCurrent user infoany
PUT/api/v1/auth/me/themeUpdate theme preferencesany
POST/api/v1/auth/change-passwordChange own passwordany

Users (Admin)​

MethodEndpointDescriptionRole
GET/api/v1/usersList usersadmin
POST/api/v1/usersCreate useradmin
PUT/api/v1/users/{id}Update useradmin
DELETE/api/v1/users/{id}Delete useradmin

Vigil AI (Vision)​

MethodEndpointDescriptionRole
GET/api/v1/vision/detectionsList detectionsviewer+
GET/api/v1/vision/settingsGet detection settingsviewer+
PUT/api/v1/vision/settingsUpdate thresholdsadmin
GET/api/v1/vision/modelsList ONNX modelsviewer+
POST/api/v1/vision/modelsUpload ONNX modeladmin

Notifications & Alerts​

MethodEndpointDescriptionRole
GET/api/v1/alertsList alertsviewer+
PUT/api/v1/alerts/{id}/readMark alert readany
DELETE/api/v1/alerts/{id}Delete alertoperator+
GET/api/v1/alerts/preferencesGet notification preferencesany
PUT/api/v1/alerts/preferencesUpdate notification preferencesany
tip

This is a summary of the most commonly used endpoints. Your instance's Swagger UI at /api/v1/docs is the complete, always-current reference with request/response schemas and a "Try it out" feature.