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

# Introduction

> Build against the Basics Gateway API for chat, embeddings, audio, and email.

Build on top of Basics Gateway with one API for chat, embeddings, audio, and email.

Use this docs site to find the right endpoint, choose an auth model, and ship faster with fewer integration decisions.

## Start here

Start with the core pages below.

> **[API introduction](https://basicsos.com/docs/api-reference/introduction.md)**
>
> See the base URLs, API areas, and endpoint map.

> **[Authentication](https://basicsos.com/docs/api-reference/authentication.md)**
>
> Learn when to use a Basics API key and BYOK headers.

> **[Public API](https://basicsos.com/docs/api-reference/chat-and-embeddings.md)**
>
> Start with chat, embeddings, and core request patterns.

> **[Connections and execute](https://basicsos.com/docs/api-reference/connections-and-execute.md)**
>
> Connect provider accounts and run user-scoped actions.

## Self-hosted deployments

Running your own BasicsOS server? The CRM API is a separate set of endpoints on your server for managing contacts, companies, deals, and more.

> **[Self-hosted CRM API](https://basicsos.com/docs/self-hosted-crm/introduction.md)**
>
> REST API for contacts, companies, deals, tasks, notes, and custom objects on your own BasicsOS server.

## Key capabilities

These are the main building blocks most integrations use first.

> **[Model discovery](https://basicsos.com/docs/api-reference/health-and-models.md)**
>
> Fetch active model aliases before making requests.

> **[Audio and email](https://basicsos.com/docs/api-reference/audio-email.md)**
>
> Transcribe audio, generate speech, and send tenant-scoped email.

> **[Error handling](https://basicsos.com/docs/api-reference/errors.md)**
>
> Handle shared gateway errors consistently.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.