/
PR
printhiv3d
/
Hive API Documentation
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Checked 14h ago · Updated 14h ago
View markdown
printhiv3d
Hive API Documentation
post
Resolve a local printer to its canonical cloud identity
OpenAPI 3.0.3
2026-08-20
531
0
520.9 KB
6fe5e0368cb0
Action Feed
7
Agent Auth
2
AMS
2
Analytics
5
API Keys
8
Assistant
1
Assistant Feedback
5
Feature Flags
2
Filament Consumption
8
Files
8
Hex
17
Hive Link
11
post
Issue a short-lived paired-Host transfer credential and optionally bootstrap Pulse
post
Revoke the paired desktop's Pulse Host credential
get
List safe organization printer metadata with authoritative Host ownership
post
Resolve a local printer to its canonical cloud identity
post
Atomically claim an unassigned cloud printer for a paired Host
post
Assign or lease-safely move a cloud printer to a paired Hive Link Host
post
Issue a scoped Hive Link launch intent
post
Issue a file-only direct-transfer ticket
post
Resolve a signed desktop launch capability
post
Reserve a signed direct-transfer capability
post
Redeem a received direct-transfer capability
HiveSlice
10
Hosts
7
Inventory
3
Inventory Orders
7
Inventory Transactions
1
Lifecycle Emails
4
Loop Runs
8
Maintenance
9
Makes
16
Materials
10
ML Models
2
Mobile Briefing
1
Model Files
10
Models
24
OAuth
7
OAuth Clients
5
Onboarding
2
Operator Dispatch
8
Operator Sessions
1
Order Items
2
Orders
7
Organizations
6
Platform Credentials
4
Print Jobs
4
Printer Control
8
Printer Tags
12
Printers
15
Product SKUs
9
Production Capacity
6
Production Runs
15
Public
1
Purchase Requests
11
Recommendation Receipts
10
RPI Image
4
Shippo
5
Shopify
9
Shopify SKU Mapping
1
Slicer
4
Slicer Gateway
3
Smart Queue
3
Sub-Tasks
18
Subscriptions
1
Support
1
Tasks
7
Telemetry
3
Training
8
Veeqo
4
get
/.well-known/openai-apps-challenge
get
/.well-known/integrations.json
get
/.well-known/mcp/server-card.json
get
/openapi.json
get
/v1/mcp/
post
/v1/mcp/
delete
/v1/mcp/
get
/v1/agent/identity/claim/inspect
post
/v1/agent/identity/claim/confirm
post
/v1/printer-events
post
/v1/printer-events/batch
get
/v1/printer-config
post
/v1/printer-config
get
/v1/printer-config/{id}
patch
/v1/printer-config/{id}
patch
/v1/printer-config/{id}/connection-status
post
/v1/printer-config/{id}/test-connection
post
/v1/printers/{id}/filaments/assign
patch
/v1/printers/{id}/maintenance
post
/v1/printers/{id}/operator-device-start
patch
/v1/printers/{id}/ready
post
/v1/printers/{id}/commands
put
/v1/printers/{id}/filaments/{position}
delete
/v1/printers/{id}/filaments/{position}
post
/v1/printers/{id}/ftp-health/failure
post
/v1/printers/{id}/ftp-health/success
post
/v1/printers/{id}/next-job
patch
/v1/printers/{id}/lock
get
/v1/printers/{id}/status
get
/v1/printers/{id}/frame
patch
/v1/printers/{id}/delete
get
/v1/printers/upload-speed
get
/v1/printers/orphaned-jobs
post
/v1/print-jobs/create
post
/v1/print-jobs/reorder
patch
/v1/print-jobs/{id}/assign
post
/v1/print-jobs/{id}/start
post
/v1/print-jobs
patch
/v1/print-jobs/{id}/status
get
/v1/print-jobs/{id}
delete
/v1/print-jobs/{id}
get
/v1/print-jobs/{id}/history
post
/v1/print-jobs/{id}/history
patch
/v1/print-jobs/{id}/retry
patch
/v1/print-jobs/{id}/file-verification
get
/v1/batch-jobs
post
/v1/batch-jobs
get
/v1/batch-jobs/{id}
patch
/v1/batch-jobs/{id}
get
/v1/batch-jobs/{id}/dashboard
post
/v1/batch-jobs/{id}/cancel
patch
/v1/batch-jobs/{id}/cancel
post
/v1/batch-jobs/empty
post
/v1/batch-jobs/{id}/jobs
post
/v1/batch-jobs/{id}/remove-jobs
post
/v1/batch-jobs/{id}/archive
post
/v1/batch-jobs/{id}/unarchive
get
/v1/listings
post
/v1/listings
get
/v1/listings/{id}
delete
/v1/listings/{id}
patch
/v1/listings/{id}
post
/v1/listings/{id}/sync
get
/v1/onboarding/status
post
/v1/onboarding/complete
post
/v1/loop-jobs
get
/v1/loop-jobs/{id}
post
/v1/discord/interactions
post
/v1/discord/webhook
get
/v1/discord/oauth-callback
get
/v1/discord/register-commands
get
/v1/discord/command-status
get
/v1/discord/debug-commands
get
/v1/notifications
post
/v1/notifications
post
/v1/notification-targets
post
/v1/notification-targets/device
get
/v1/notification-preferences
put
/v1/notification-preferences/org
put
/v1/notification-preferences/user
delete
/v1/notification-preferences/user/{eventType}
get
/v1/notification-preferences/printers/{printerId}
put
/v1/notification-preferences/printers/{printerId}
delete
/v1/notification-preferences/printers/{printerId}/{eventType}
get
/v1/recurring-error-config
put
/v1/recurring-error-config
get
/v1/printer-errors
delete
/v1/printer-errors
get
/v1/printer-errors/stats
get
/v1/farm-briefings/config
patch
/v1/farm-briefings/config
post
/v1/farm-briefings/preview
post
/v1/internal/farm-briefings/daily
get
/v1/at-risk-alerts/config
patch
/v1/at-risk-alerts/config
post
/v1/at-risk-alerts/preview
post
/v1/internal/at-risk-alerts/run
get
/v1/notification-control-center
put
/v1/notification-control-center/briefing
put
/v1/notification-control-center/at-risk-alerts
Hive Link
Resolve a local printer to its canonical cloud identity
post
/v1/hive-link/printers/resolve
Request body
object
required
hostId
string
required
ip
string
required
name
string
serial
string
model
string
protocol
'bambu'
|
'klipper'
|
'octoprint'
|
'prusa_connect'
|
'snapmaker'
required
createIfMissing
boolean
Response
Default Response
object
required
cloudPrinterId
string
ownership
object