> ## Documentation Index
> Fetch the complete documentation index at: https://docs.buildbetter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# BuildBetter API Documentation

> Use the BuildBetter REST API to integrate your applications and workflows with our data platform.

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.

<Warning>
  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.
</Warning>

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

<CardGroup cols={2}>
  <Card title="Authentication & Setup" icon="key" href="/pages/api/authentication">
    Learn how to authenticate your REST API requests.
  </Card>

  <Card title="Legacy GraphQL Queries" icon="code-branch" href="/pages/api/query-building">
    Reference existing GraphQL integrations while migrating to REST.
  </Card>

  <Card title="Accessing Data Models" icon="database" href="/pages/api/data-access">
    Explore the core data types: Calls (Interviews), Signals (Extractions), and Documents.
  </Card>

  <Card title="Recordings REST API" icon="file-audio" href="/pages/api/recordings">
    Create recordings, attach media, and fetch transcripts using public UUIDs.
  </Card>

  <Card title="Metadata REST API" icon="tags" href="/pages/api/metadata">
    Manage source namespaces and typed field definitions for API records.
  </Card>

  <Card title="Legacy GraphQL Examples" icon="file-code" href="/pages/api/graphql-examples">
    See legacy query examples for migration reference.
  </Card>

  <Card title="Error Handling & Best Practices" icon="shield-check" href="/pages/api/error-handling">
    Learn how to handle API errors and follow best practices for efficient integration.
  </Card>
</CardGroup>