Print Hive API Documentation

The Print Hive API lets you manage models, files, makes, print jobs, and smart queue orchestration for your own printers. Only routes explicitly marked as public are shown in our API docs.

Base URL

https://api.printhiv3d.com/v1

Versioning

All routes are prefixed with /v1. We use additive changes and deprecations before removals.

Authentication

• API Key: send x-api-key header
• JWT: send Authorization: Bearer <token>

Rate Limits

Anonymous requests are rate limited to 600 requests per IP per 60 seconds, reported through the RateLimit-Policy and RateLimit headers (with live remaining and reset values) so clients can self-throttle. The budget is enforced on the public discovery endpoints (/openapi.json, /health, /.well-known/*): when exhausted, those return 429 with a Retry-After header and a typed error body. Authenticated usage is governed by your plan limits and never counts against the anonymous budget.

Error format

Every failure response uses one JSON schema, published as the Error schema in our OpenAPI specification:

{
  "error": "Bad Request",
  "message": "Explanation of the error"
}

error is the machine-readable code; message is the human-readable explanation.