Connections

Gets one of your connections by the agent's instance id.

get/api/Connections/{instanceId}

Request

  • Base URL: https://api.3dprintlog.com
  • URL: https://api.3dprintlog.com/api/Connections/{instanceId}
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://3dprintlog.auth0.com/authorize, token URL https://3dprintlog.auth0.com/oauth/token)
    • API key in header X-Api-Key
    • API key in query parameter api_key

Path parameters

instanceIdstring required

The agent's own stable id for the printer.

Response

The connection.

idstring uuid
kindstring nullable

The connector type, lower-case: moonraker, octoprint.

instanceIdstring nullable

The agent's own stable id for this printer.

displayNamestring nullable
agentVersionstring nullable
latestAgentVersionstring nullable

The newest release of this connection's agent (printlog-bridge for moonraker), as X.Y.Z, or null when 3D Print Log doesn't know it. Read from the agent's GitHub tags every few hours, so agents learn of an update from their check-in and never call GitHub.

updateAvailableboolean

Whether PrintLogApi.Models.DTOs.Connection.ConnectionDto.AgentVersion is older than PrintLogApi.Models.DTOs.Connection.ConnectionDto.LatestAgentVersion.

printerIdinteger nullable

The printer this connection logs prints for, or null when it is not bound to one.

createdDatestring date-time
lastSeenAtstring date-time

When the agent last sent a heartbeat.

status1 | 2

Whether a connection's agent is still sending heartbeats.

Sent as an integer: 1 = Online, 2 = Stale.

droppedNotifierEventCountinteger

Moonraker notifier events dropped because this connection logs the same printer. Each job is logged once, by the connection.

lastDroppedNotifierEventAtstring date-time nullable

When a notifier event was last dropped.

notifierNoticeDismissedAtstring date-time nullable

When you dismissed the notice about the notifier.

showNotifierNoticeboolean

Whether to suggest removing the [notifier] section from moonraker.conf: events were dropped and the notice has not been dismissed.

modestring nullable

How the agent reaches the printer: local or remote.

klipperVersionstring nullable
moonrakerVersionstring nullable
printerModelstring nullable

The printer model the slicer wrote in the last job's file.

outboxDepthinteger nullable

Events and pictures waiting in the agent's outbox to be sent.

outboxOldestQueuedAtstring date-time nullable

When the oldest of them was queued.

lastErrorstring nullable

The last warning or error the agent logged for this printer.

lastErrorAtstring date-time nullable

When it was logged.

errorCountinteger nullable

Warnings and errors logged between the agent's last two heartbeats.

snapshotsboolean nullable

Whether a webcam frame is added to each print.

slicerSettingsboolean nullable

Whether each print's slicer settings are sent.

Changes

No recorded changes to this operation across all 1 revision of this API.