Skip to main content
Welcome to the BuildBetter API documentation. The REST API is the supported path for new customer integrations, including creating recordings, attaching media, managing metadata definitions, and reading transcripts by public recording UUID.
The BuildBetter API is under active development and may change as we improve it. When we intend to make a breaking change, we will make a best-effort attempt to notify affected customers in advance, but advance notice is not guaranteed. Monitor these API docs and avoid relying on undocumented behavior.
The GraphQL API is being deprecated for customer integrations. Move new and existing integrations to the REST API. The GraphQL pages remain available as legacy migration reference while customers transition.
Whether you’re looking to build custom integrations, automate workflows, or extract specific insights, this guide will help you get started and make the most of our API.

​
Getting Started

Authentication & Setup

Learn how to authenticate your REST API requests.

Legacy GraphQL Queries

Reference existing GraphQL integrations while migrating to REST.

Accessing Data Models

Explore the core data types: Calls (Interviews), Signals (Extractions), and Documents.

Recordings REST API

Create recordings, attach media, and fetch transcripts using public UUIDs.

Agent Chats SDK & API

Send your agent conversations and message feedback. Start with HTTP or explore the Node SDK preview.

Metadata REST API

Manage source namespaces and typed field definitions for API records.

Legacy GraphQL Examples

See legacy query examples for migration reference.

Error Handling & Best Practices

Learn how to handle API errors and follow best practices for efficient integration.