---
title: "Resellers"
description: "Admin endpoints for managing resellers and their billing state in the Xtream AI API."
---

# Resellers

Admin endpoints for managing resellers and their billing. A reseller key can only reach `POST /resellers` and only to create a sub-reseller under itself. All other endpoints in this group require an admin key with the `resellers:read` or `resellers:write` scope.

## Endpoints

| Endpoint | Method and path | What it does |
|---|---|---|
| [List resellers](/docs/?page=xai-ref-resellers-list) | `GET /resellers` | Paginated list of every reseller on the panel. |
| [Create a reseller](/docs/?page=xai-ref-resellers-create) | `POST /resellers` | Creates a reseller (admin) or a sub-reseller under the caller (reseller with `subresellers:write`). |
| [Get a reseller](/docs/?page=xai-ref-resellers-get) | `GET /resellers/{id}` | Full record for one reseller. |
| [Update a reseller](/docs/?page=xai-ref-resellers-update) | `POST /resellers/{id}/update` | Applies a partial update to the reseller's profile and permissions. |
| [Read billing state](/docs/?page=xai-ref-resellers-billing) | `GET /resellers/{id}/billing` | Current billing mode (credits or users), balance and effective caps. |
| [Adjust billing](/docs/?page=xai-ref-resellers-billing-adjust) | `POST /resellers/{id}/billing/adjust` | Applies a delta to the reseller's credit balance or user cap. |