Skip to main content
All Poelis Public API requests must include a valid API key. This page is the API reference for the exact request shape; for obtaining keys and operational guidance, see Authentication.

​
Required Header

Send your API key in the Authorization header using Bearer token format: 
Authorization: Bearer poelis_api_YOUR_KEY_HERE
The key must be sent on every request. There is no session or cookie-based auth.

​
Scoping

API keys are organization-scoped: they grant access to all workspaces, products, and items in that organization.

​
Missing or Invalid Key

If the header is missing or the key is invalid/revoked, the API returns 401 Unauthorized. See Status Codes and Response Format for the canonical error body shape.