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

# Overview

> Overview and authentication for the Envole API

The Envole API provides a RESTful interface for building assistants. You can create session threads, post messages with mixed content, and stream real‑time updates as the agent works.

## Authentication

All requests require:

* `Authorization: Bearer <token>` – your API key
* `X-Envole-User-Id: <user-id>` – user identifier; may represent an Envole user or an external ID

## Capabilities

* Start new session threads and manage existing ones
* Send messages containing text or files
* Stream agent responses, tool approvals, and notifications via Server-Sent Events
* Retrieve previous threads and messages

Refer to the [Streaming](./streaming/index) section for event formats and SSE details.