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

# Introduction

> Send your customers and their conversations to Cerium from your own backend, and let your support team and AI agent take it from there.

The Cerium API lets your backend hand customers and their messages to Cerium. Your support team and AI agent reply from the Cerium inbox, and you read the replies back through the same API.

> [card] [Quickstart](/quickstart.md)
>
> Send your first customer message in five minutes.

> [card] [Authentication](/authentication.md)
>
> Create an API key and learn what each scope allows.

> [card] [Core concepts](/concepts.md)
>
> Customers, conversations and messages, and how they fit together.

> [card] [API reference](/api-reference/introduction.md)
>
> Every endpoint, with parameters, responses and examples.

## What you can do

> [accordion] Register your customers
>
> Create a customer once with your own user id. Sending the same customer again is safe: you get the existing one back.

> [accordion] Start and continue conversations
>
> Start a conversation with the customer's first message, then add more messages as they write.

> [accordion] Read the replies
>
> List the messages in a conversation to show your team's and your AI agent's replies in your own app.

> [accordion] Close and reopen
>
> Close a conversation when it is resolved, or reopen it.

> [accordion] Honour data-protection requests
>
> Erase a customer's personal data on request.

## The shape of the API

| | |
| - | - |
| **Base URL** | `https://api.usecerium.com/v1` |
| **Format** | JSON requests and responses over HTTPS |
| **Authentication** | `Authorization: Bearer <your API key>` |
| **Resources** | [Customers](/guides/customers.md), [Conversations](/guides/conversations.md), [Messages](/guides/messages-and-attachments.md) |

Every successful response has the same envelope:

```json
{
  "message": "Customer retrieved successfully.",
  "status": "success",
  "data": {},
  "meta": {}
}
```

`data` holds the result. `meta` is present on lists and describes the page.

> [!NOTE]
>
> The API is for your **servers**. Never put an API key in a mobile app or in browser code.
