Skip to main content

API Key

For authentication, the pubrio-api-key header needs to be included. The header should contain the api key, for example a a1b2c3d4e5f6g7h8 which represents your API key.
You need to create an API key to access the Pubrio API. To create an API key, you can do so by accessing the Settings section.
The API key already includes your workspace (profile) information, so you do not need to pass profile_id in your request body. The profile_id parameter is still accepted for backward compatibility but is no longer required.

Request headers

Along with pubrio-api-key, send a User-Agent header identifying your client.
A missing or generic User-Agent is rejected before it reaches the API. Requests without a recognised user agent are blocked at the edge and return HTTP 403 with the plain-text body error code: 1010 — not JSON, and not one of the documented error codes. This looks like an authentication failure but is not: your API key is fine.Default user agents from common HTTP libraries are affected — Python’s urllib (Python-urllib/3.x) is blocked, while curl and requests are not. If you get error code: 1010, set an explicit User-Agent and retry.
Last modified on August 20, 2026