Resellers

Endpoints for managing resellers and their billing. An admin key reaches all of them with the resellers:read and resellers:write scopes. A reseller key reaches two things, both limited to its own sub-resellers: POST /resellers to create one under itself (subresellers:write), the three read endpoints (list, get and billing) to see its sub-resellers and theirs (subresellers:read), and POST /resellers/{id}/billing/adjust to transfer credits from its own balance to them (subresellers:credits). Updating a reseller stays admin-only.

Endpoints

Endpoint	Method and path	What it does
List resellers	GET /resellers	Paginated list of every reseller on the panel (admin), or of the caller's own sub-resellers (reseller with subresellers:read).
Create a reseller	POST /resellers	Creates a reseller (admin) or a sub-reseller under the caller (reseller with subresellers:write).
Get a reseller	GET /resellers/{id}	Full record for one reseller. Reseller keys: own sub-resellers only.
Update a reseller	POST /resellers/{id}/update	Applies a partial update to the reseller's profile and permissions.
Read billing state	GET /resellers/{id}/billing	Current billing mode (credits or users), balance and effective caps. Reseller keys: own sub-resellers only.
Adjust billing	POST /resellers/{id}/billing/adjust	Applies a delta to the reseller's credit balance or user cap (admin), or transfers credits from the caller's balance (reseller with subresellers:credits).