Authentication

​

Get your API key

1. Log in to the Ondial dashboard.
2. Open API Access.
3. Submit a request with:
   • Key name — friendly label (e.g. Production CRM) shown in your list and to Super Admin
   • Mode — sandbox or live
   • Why — short use-case note for approval
4. Super Admin approves (or denies). On approve, the operator receives the plaintext key once.
5. Optionally Rename the key later in API Access (does not change the secret).

​

Try It

1. Open Ping.
2. Paste the key into BearerAuth (playground adds Bearer).
3. Choose Production or Local (localhost:3001).
4. Send.

​

cURL

export ONDIAL_BASE_URL="https://dashboard.ondial.ai"
export ONDIAL_API_KEY="ond_test_xxxxxxxx"

curl -sS -H "Authorization: Bearer $ONDIAL_API_KEY" \
  "$ONDIAL_BASE_URL/api/v1/ping"

​

Revoke / rotate / kill switch

• Tenant Rotate / Delete from API Access (or Super Admin rotate/revoke) → old secret stops working
• Super Admin revoke / suspend → 401 unauthorized
• Global kill switch → 503 api_globally_disabled on all /api/v1/*