> ## Documentation Index
> Fetch the complete documentation index at: https://docs.convocore.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Started

> Overview of Convocore API versions, regions, authentication, and where to begin.

Convocore exposes multiple API surfaces, but for most new integrations you should start with **V3 REST**.

## Choose the right API

### V3 REST

Recommended for new integrations.

* Bearer-authenticated
* Resource-oriented
* Best for workspaces, agents, tools, variables, knowledge base docs, leads, and conversations

### V2 / legacy

Still available for older integrations that depend on legacy endpoint behavior.

### WebSocket interact

Best when you need real-time streaming responses during a live conversation.

## Region-specific base URLs

Pick the region that matches your workspace:

### V3

* EU: `https://eu-gcp-api.vg-stuff.com/v3`
* NA: `https://na-gcp-api.vg-stuff.com/v3`

### V2

* EU: `https://eu-cloudflare.vg-stuff.com`
* NA: `https://na-cloudflare.vg-stuff.com`

<Warning>
  Using the wrong region can cause authentication failures or data mismatches.
</Warning>

## Authentication

Most protected endpoints use:

```bash theme={null}
Authorization: Bearer YOUR_SECRET_KEY
```

You can use either:

* A **workspace secret**
* An **agent secret**

<Frame caption="Get a workspace secret from the workspace selector in the dashboard.">
  <img src="https://i.ibb.co/XjVNjdV/Untitled.jpg" />
</Frame>

<Frame caption="Get an agent secret from the agent Settings page.">
  <img src="https://i.ibb.co/vY8CbgL/Capture.png" />
</Frame>

## Where to go next

<CardGroup cols={2}>
  <Card title="V3 API Intro" icon="rocket" href="/api-reference/v3/intro">
    Start with the recommended API for new integrations.
  </Card>

  <Card title="Authentication" icon="shield-halved" href="/api-reference/authentication">
    Learn how secrets and authorization work.
  </Card>

  <Card title="Endpoints" icon="server" href="/api-reference/endpoints">
    Review V2, V3, and WebSocket hosts by region.
  </Card>
</CardGroup>