API Reference

QNSP REST API reference — authentication, endpoints, pagination, errors, and versioning.

API Reference

The QNSP REST API is the foundation for all programmatic access to the platform. All requests are proxied through the edge gateway at https://api.qnsp.cuilabs.io.

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.qnsp.cuilabs.io/vault/v1/secrets

See Authentication for how to obtain an access token.