Skip to main content
Cor has three separate credentials. They are not interchangeable. Use the right one for each job.
CredentialUsed byWhere it runsHow it is sent
SDK API keyObi widgetBrowser (client-side)apiKey in obiWidgetConfig
Reporting tokenSession Reporting APIYour serverAuthorization: Token <token>
Onboardee context tokenUser Context APIYour serverAuthorization: Token <token>
The SDK API key is public. It ships in your page source, and that is fine. The reporting and context tokens are secrets. Never put them in client-side code.

SDK API key

This key identifies your app to the Obi widget. It is safe to expose in the browser. You pass it when you configure the widget:
window.obiWidgetConfig = {
  apiKey: "your-api-key",
};
See Installation.

API tokens

The Session Reporting API and the User Context API both use the Token scheme. Send the token in the Authorization header:
Authorization: Token <your-api-token>
curl -s -H "Authorization: Token <your-api-token>" \
  "https://app.coragents.ai/api/sessions/reporting?limit=5"
The reporting token and the onboardee-context token may be different tokens. If a call returns 401, confirm you are using the right one for that API. Contact your account manager if you are unsure.

Getting credentials

All Cor credentials are provisioned by the Cor team. If you do not have a key or token, contact your account manager.

Base URL

All API requests go to:
https://app.coragents.ai