Skip to content

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-Key or Authorization: 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