API Reference

QNSI REST API reference - authentication, endpoints, pagination, errors, and versioning.

The QNSI REST API is the foundation for all programmatic access to the platform. All requests are proxied through the edge gateway at https://api.qnsi.heossi.com.

In This Section

  • Overview - Base URL, request format, content types
  • Authentication - API keys, Bearer tokens, tenant headers
  • Reference - Complete endpoint listing by service
  • Pagination - Cursor-based pagination for list endpoints
  • Idempotency - Safe retries with idempotency keys
  • Errors - Error object schema and HTTP status codes
  • Versioning - API versioning policy and stability guarantees

Quick Example

curl -sS \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "x-qnsp-tenant-id: $TENANT_ID" \
  https://api.qnsi.heossi.com/vault/v1/secrets

See Authentication for how to obtain an access token.