Copy page

Guides

SDKs

CALL-E provides server SDKs for trusted backend services, workers, and automation systems that create and monitor call tasks.

Packages

TypeScript package name:

Code
@call-e/calle

Python distribution name:

Code
calle-ai

Python imports the package as calle:

Code
from calle import CalleClient

Package status

The current stable server SDK packages are:

• TypeScript: @call-e/calle@0.7.0
• Python: calle-ai==0.7.0

These stable packages support both the request-scoped Calls API and the Goal Runs SDK surface described below.

Goal Runs

The Goal-based SDK surface keeps published contracts separate from the one-shot Calls API:

• TypeScript: client.goals.list(...), get(...), run(...), getRun(...), waitForResult(...), and runAndWait(...)
• Python: client.goals.list(...), get(...), run(...), get_run(...), wait_for_result(...), and run_and_wait(...)

Run requests contain Goal identity, one phone number, per-Run variables, and an idempotency key. They do not accept request-scoped task text, prompts, input_schema, or result_schema; those fields are owned by the published RunSpec. See the Goal Runs guide for the API contract and SDK examples.

Source code

The TypeScript SDK is maintained in a public repository. The Python package is available from PyPI, but its source repository is not currently public.

Runtime	Package	Repository
TypeScript	@call-e/calle	CALLE-AI/server-sdk-typescript
Python	calle-ai	Not currently public

The TypeScript repository includes public source code, examples, and security guidance:

• TypeScript security policy

Local examples

The TypeScript SDK repository includes runnable examples for the server-side one-shot call task flow.

TypeScript:

Code
git clone https://github.com/CALLE-AI/server-sdk-typescript.git
cd server-sdk-typescript
pnpm install
pnpm run example:create-and-wait

Calls API

The SDKs expose context as a reserved input for future SDK-side workflow data. The current SDKs do not send context to the API.

Examples use phone placeholders such as <E164_PHONE> and <RECIPIENT_1_E164_PHONE>. Replace them with phone numbers you own or are authorized to call.

The SDKs accept structured result schemas as plain JSON objects. Use field description values to explain how CALL-E should interpret enum values, and use type, required, enum, and additionalProperties for hard validation. See the Calls guide for structured result design patterns and examples.

TypeScript:

Code
const created = await client.calls.create(
  {
    task: "Call each recipient and ask whether they can attend Friday lunch in San Francisco.",
    recipients: [
      { phones: ["<RECIPIENT_1_E164_PHONE>"] },
      { phones: ["<RECIPIENT_2_E164_PHONE>"] },
    ],
    resultSchema: {
      type: "object",
      required: ["attending_count"],
      properties: {
        attending_count: { type: "integer" },
      },
    },
    recipientResultSchema: {
      type: "object",
      required: ["can_attend"],
      properties: {
        can_attend: { type: "string", enum: ["yes", "no", "unknown"] },
      },
    },
  },
  { idempotencyKey: "wf_123_friday_lunch" },
);

const fetched = await client.calls.get(created.id);
const completed = await client.calls.waitForResult(fetched.id);
const createdAndCompleted = await client.calls.createAndWait(
  {
    task: "Call <E164_PHONE> and confirm their preferred appointment time.",
    resultSchema: {
      type: "object",
      required: ["preferred_time"],
      properties: {
        preferred_time: { type: "string" },
      },
    },
  },
  { timeoutMs: 120_000, intervalMs: 2_000 },
);
const events = await client.calls.listEvents(createdAndCompleted.id, {
  limit: 50,
});

Python:

Code
created = client.calls.create(
    task="Call each recipient and ask whether they can attend Friday lunch in San Francisco.",
    recipients=[
        {"phones": ["<RECIPIENT_1_E164_PHONE>"]},
        {"phones": ["<RECIPIENT_2_E164_PHONE>"]},
    ],
    result_schema={
        "type": "object",
        "required": ["attending_count"],
        "properties": {"attending_count": {"type": "integer"}},
    },
    recipient_result_schema={
        "type": "object",
        "required": ["can_attend"],
        "properties": {
            "can_attend": {"type": "string", "enum": ["yes", "no", "unknown"]},
        },
    },
    idempotency_key="wf_123_friday_lunch",
)

fetched = client.calls.get(created["id"])
completed = client.calls.wait_for_result(fetched["id"])
created_and_completed = client.calls.create_and_wait(
    task="Call <E164_PHONE> and confirm their preferred appointment time.",
    result_schema={
        "type": "object",
        "required": ["preferred_time"],
        "properties": {"preferred_time": {"type": "string"}},
    },
    timeout_seconds=120,
    interval_seconds=2,
)
events = client.calls.list_events(created_and_completed["id"], limit=50)

Availability

Install the stable server SDK package for your runtime:

Code
pnpm add @call-e/calle
pip install calle-ai

Use pinned versions when your deployment process requires exact package reproducibility:

Code
pnpm add @call-e/calle@0.7.0
pip install calle-ai==0.7.0

Supported scope

This release does not include:

• Python async client support
• Project-level webhook management
• Client-initiated cancellation of in-flight calls
• Recurring or scheduled calls
• Zod result schema helpers
• Pydantic result schema helpers