Authorization
- We use Bearer token to authorize any request for agents (except for public interact, analytics endpoints), workspaces, Kb, conversations, analytics, etc
- You can use either the agent secret key or the workspace secret, both are present in your dashboard.
To get a Workspace Secret: Convocore Dashboard > Top left > Select workspace you want > Copy Workspace secret
To get the Agent secret: Convocore Dashboard > Agent > Settings > Scroll down
Plan requirement (v2 pricing)
Public REST API access (/v3/*) requires a paid plan on the current v2-2026 pricing catalog:
Free, Starter, and Pro do not include API access. Legacy Pay-as-you-go workspaces are unchanged.
When a request is blocked, the API returns
403 with a link to your billing / plans page so you can upgrade.