API Reference
Notes:
Public API v1 is currently in feature preview and as such documentation for this feature is still work in progress
The Public API v1 is documented in this section. Current endpoints and response formats that are available in this preview are covered.
Base URL
- The base URL for all Public API v1 requests is
https://xpna.app/api/public/v1.
Authentication
- Either
X-Api-KeyorAuthorization: Bearer <token>is required for access. - The same API keys used for OData are used for Public API v1.
- API keys are managed in the xpna task pane. See API Keys.
Response format
- All successful responses are wrapped in a standard envelope.
- The response payload is returned under
data. - Response metadata is returned under
meta.
Errors
- Error responses are returned as RFC 9457 problem details.
- The response content type is
application/problem+json.
Rate limits
- Rate limits are enforced per API key.
- 429 responses include rate limit headers and retry guidance.
Endpoints
- Endpoints are grouped under the Endpoints navigation section.
- Connections
- Identity