Skip to content
Decibyl AI

Introduction

Decibyl ships official SDKs for Python and TypeScript that wrap the Decibyl REST API and the workflow builder. Use them to create or edit agents, place outbound calls, and inspect runs from your own code.

Both packages are generated from the same backend OpenAPI spec, so the method surface is equivalent — only the naming convention differs (snake_case in Python, camelCase in TypeScript).

Install

Terminal window
pip install decibyl-sdk
Terminal window
npm install @decibyl/sdk

Authenticate

Generate an API key at /api-keys. See API Keys for details.

Both SDKs read the API key from the DECIBYL_API_KEY environment variable by default, and the base URL from DECIBYL_API_URL. You can also pass them explicitly.

from decibyl_sdk import DecibylClient


client = DecibylClient(
    base_url="https://app.decibyl.ai",
    api_key="YOUR_API_KEY",
)
import { DecibylClient } from "@decibyl/sdk";


const client = new DecibylClient({
    baseUrl: "https://app.decibyl.ai",
    apiKey: "YOUR_API_KEY",
});

Quick tour

List the agents in your workspace:

workflows = client.list_workflows()
for wf in workflows:
    print(wf.id, wf.name)
const workflows = await client.listWorkflows();
for (const wf of workflows) {
    console.log(wf.id, wf.name);
}

Next steps