Skip to main content
V3 is the recommended Convocore API for new integrations.

​
Base URLs

Your workspace lives in either the EU or NA region. Use the base URL that matches your dashboard region.

​
EU

https://eu-gcp-api.vg-stuff.com/v3

​
NA

https://na-gcp-api.vg-stuff.com/v3
If you use the wrong region, requests may fail or return data from the wrong environment.

​
Authentication

Most V3 endpoints use a standard Bearer token: 
Authorization: Bearer YOUR_SECRET_KEY
You can authenticate with either:
  • Your workspace secret for workspace-level operations
  • Your agent secret for agent-specific operations

​
What V3 covers

The V3 API is organized around the main product objects:
  • Workspaces
  • Agents
  • Tools
  • Variables
  • Knowledge Base
  • Leads
  • Conversations
  • Calls & Numbers
  • Campaigns
  • Custom Metrics
Use the sidebar to jump directly into any resource group.

​
Region-aware request example

curl --request GET \
  --url https://eu-gcp-api.vg-stuff.com/v3/agents \
  --header "Authorization: Bearer YOUR_SECRET_KEY"

​
Choosing between API surfaces

  • Use V3 REST when you want a stable, Bearer-authenticated HTTP API.
  • Use V2 / legacy endpoints only if you are maintaining an older integration that already depends on them.
  • Use WebSocket interact when you need real-time streaming behavior during live conversations.

​
Next steps

Authentication

Learn how secrets work and how to authorize requests safely.

Endpoints & Regions

Review all available API base URLs, including V2, V3, and WebSocket endpoints.