Skip to main content

Authentication & Quotas

Authentication​

Required Headers​

Every API request must include two headers:

authorization: ApiKey YOUR_API_KEY
x-printago-storeid: YOUR_STORE_ID
  • authorization — your API key, prefixed with ApiKey .
  • x-printago-storeid — the ID of the organization (store) you are accessing. You can find this on the API Keys page.

Requests missing either header will receive a 401 Unauthorized response.

How Permissions Apply​

An API key's effective permissions are the union of its directly assigned permissions and any permissions inherited from assigned roles. If a key attempts an action it does not have permission for, the request returns 403 Forbidden.

Full Access keys behave as Store Owner and can perform any action.

Rate Limits​

API access is rate-limited across two sliding windows:

WindowLimit
Per minute60 requests
Per hour600 requests

When you exceed a limit, requests return HTTP 429 Too Many Requests until the window resets. The response includes a Retry-After header indicating how long to wait.

tip

If these limits are too restrictive for your use case, contact us to discuss higher quotas.

Real-time Data with MQTT​

For real-time printer updates, Printago provides MQTT access. This is the same data stream that powers the Printago web dashboard — giving you immediate access to printer states, temperatures, progress, and more.

Connection Details​

SettingValue
MQTTSmqtts://realtime.printago.io:8883
MQTT over WebSocketswss://realtime.printago.io:9001
UsernameYour store ID
PasswordYour API key
Client IDapiclient_{keyId}_{suffix} — see below

MQTT Client ID​

Your MQTT Client ID must follow the format apiclient_{keyId}_{suffix}, where:

  • keyId is the first 24 characters of your API key (this is the Key ID shown on the API Keys page).
  • suffix is any string you choose to make the connection unique (e.g. a timestamp or app name).

For example, if your API key is abc123def456ghi789jkl012secret..., your Client ID would be something like apiclient_abc123def456ghi789jkl012_myapp.

tip

The Key ID is also available on the API Keys page — click the copy button next to any key to copy it.

Subscription Topics​

  • Printer stats — real-time temperature, progress, and state updates for each printer
  • Entity change events — notifications when entities (parts, orders, jobs, etc.) are created, updated, or deleted

See the API Keys page in the Printago app for full topic documentation and interactive examples.

Swagger / OpenAPI Specification​

The most current API specification is always available from the API Keys page via the Download Swagger JSON button, or directly at:

You can import this specification into tools like:

Need help? Join our Discord community for support!