Skip to main content
The Recall AI SDK supports multiple regional endpoints to ensure low-latency connections and comply with data residency requirements.

​
Configuring regions

Specify your region when initializing the Recall client: 
import { Recall } from 'recall_sdk';

const recall = new Recall({
  apiKey: 'your-api-key',
  region: 'us-east-2'
});

​
How regions work

The region parameter determines which Recall AI API endpoint your requests are sent to. The SDK constructs API URLs based on the region you specify: 
// From index.ts
const v1Url = `https://${region}.recall.ai/api/v1`;
const v2Url = `https://${region}.recall.ai/api/v2`;

​
API versions

The SDK automatically routes different features to the appropriate API version:
  • v1 API: Bot operations (create, retrieve, update, delete bots)
  • v2 API: Authentication and calendar integrations
You don’t need to worry about API versions manually - the SDK handles version routing automatically based on the operation you’re performing.

​
Available regions

Recall AI supports the following regions:

US East (Ohio)

Region code: us-east-2Primary US region with lowest latency for North American users.

Other regions

Contact Recall AI for additional regional endpoints based on your requirements.

​
Choosing a region

Consider these factors when selecting a region:
  1. Latency: Choose the region closest to your users or infrastructure
  2. Data residency: Some regulations require data to remain in specific geographic locations
  3. Availability: Verify the region is available for your account

​
Region configuration example

Set up region configuration with environment variables for flexibility: 
const recall = new Recall({
  apiKey: process.env.RECALL_API_KEY,
  region: process.env.RECALL_REGION || 'us-east-2'
});
Use us-east-2 as the default region if you’re unsure which region to choose.

​
Regional endpoint structure

All regional endpoints follow this pattern:
  • Bot endpoints: https://{region}.recall.ai/api/v1/bot
  • Auth endpoints: https://{region}.recall.ai/api/v2
  • Calendar endpoints: https://{region}.recall.ai/api/v2/calendars/
The SDK manages these URLs automatically, so you only need to specify the region once during initialization.

Build docs developers (and LLMs) love

Get started for freeTalk to us