api overview

base path, authentication, and endpoint index.

base path: /api/...

protected endpoints require:

authorization: bearer <privy_token>
circle-info

keep tokens out of logs.

quick example

curl example
curl -s \
  -H "authorization: bearer <privy_token>" \
  https://your-domain.tld/api/...

quick example

curl example
curl -s \\
  -H "authorization: bearer <privy_token>" \\
  https://your-domain.tld/api/...

endpoint groups

all endpoint docs are nested under endpoints.

common issues

  • 401 unauthorized: token missing, expired, or invalid.

  • token leaked: rotate it. remove it from logs and screenshots.

  • endpoint not found: confirm base path and environment domain.

common issues

  • 401 unauthorized: token missing, expired, or invalid.

  • token leaked: rotate it. remove it from logs and screenshots.

  • endpoint not found: confirm base path and environment domain.

Last updated