SpoolmanConnections

Connect a printer to Spoolman, or reconnect it with a new secret.

Returns the secret and a ready-to-paste block once; neither can be shown again. The block holds [spoolman] and, unless the printer has a printlog-bridge connection, a [notifier 3d_print_log] that logs its prints. Reconnecting a printer revokes its previous secret. The Free plan includes one connected printer; connecting a second returns 403 with code: "spoolman_connection_limit" and the limit.

post/api/Printers/{printerId}/spoolman-connection

Request

  • Base URL: https://api.3dprintlog.com
  • URL: https://api.3dprintlog.com/api/Printers/{printerId}/spoolman-connection
  • Auth: OAuth 2 (authorization code, authorization URL https://3dprintlog.auth0.com/authorize, token URL https://3dprintlog.auth0.com/oauth/token)

Path parameters

printerIdinteger required

The printer to connect.

Response

The new connection, with its secret.

idstring uuid
printerIdinteger nullable

The printer it is for, or null once that printer was deleted.

printerNamestring nullable

The printer's current name, or null once that printer was deleted.

namestring nullable

The printer's name when the connection was made.

createdDatestring date-time
lastSeenAtstring date-time nullable

When the printer last connected with it, or null if it never has.

statestring nullable

active, disabled (paused, see PrintLogApi.Models.DTOs.Spoolman.SpoolmanConnectionDto.DisabledReason) or revoked.

disabledReasonstring nullable

Why a disabled connection is paused: tier when Free allows only one.

disabledAtstring date-time nullable
revokedAtstring date-time nullable
secretstring nullable

The secret, URL-userinfo safe (base64url). Shown once.

serverUrlstring nullable

The server value for moonraker.conf, secret included.

configBlockstring nullable

The text to paste at the bottom of moonraker.conf: the [spoolman] section, followed by a [notifier 3d_print_log] section that logs prints unless the printer has a printlog-bridge connection (the bridge logs them itself).

Changes

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