API Reference Overview

The Sarj.ai Developer API creates, schedules, and inspects outbound voice calls.

Base URL

https://platform-api.sarj.ai/api/v1

Authentication

Send your dashboard API key as a Bearer token on API operations. GET /health is public, and recording links can also use the call-scoped token embedded in the link.

Authorization: Bearer $SARJ_API_KEY

Create and copy an API key from the Sarj.ai dashboard. The key is shown only once.

Response envelopes

Successful responses contain data and request metadata:

{
  "data": {},
  "meta": { "request_id": "550e8400-e29b-41d4-a716-446655440000" }
}

Errors contain a stable, discriminated error.type and the same metadata:

{
  "error": {
    "type": "validation_error",
    "message": "Request validation failed.",
    "field_violations": []
  },
  "meta": { "request_id": "550e8400-e29b-41d4-a716-446655440000" }
}

Branch on error.type, not on the human-readable message. Include meta.request_id when contacting support.

Start building

Quickstart

Create an API key and place your first call.

Python SDK

Install the typed sync and async client.

Webhooks

Receive call lifecycle updates without polling.

MCP Server

Give an AI agent controlled access to the API.

Last modified on September 16, 2026

​Base URL

​Authentication

​Response envelopes

​Start building