Authentication

Create an API key and authenticate requests.

Create a key under API > API keys in the dashboard. Copy the secret when it is shown; it cannot be retrieved later.

Bearer token

Store the key in ELLIPSIS_API_TOKEN:

Shell
export ELLIPSIS_API_TOKEN="ellipsis_key_..."

Send it on each request:

Shell
curl https://api.ellipsis.dev/v1/identity \
  -H "Authorization: Bearer $ELLIPSIS_API_TOKEN"

The identity response identifies the account and credential. An API key acts for its account, with no individual user identity.

Permissions

An invalid or revoked token returns 401. A valid credential without access returns 403.

Account financial settings require an owner or organization administrator's user credential. API keys and sandbox credentials cannot change them.

Revoke a key from the dashboard when it is no longer needed. Keep keys on your server; do not embed them in browser code or committed configuration.

On this page

Schedule a demo