---
title: "Lines"
description: "Endpoints for creating, updating, enabling, disabling, renewing and deleting customer subscription lines in the Xtream AI API."
---

# Lines

A **line** is one customer subscription on the panel. Every write endpoint in this group requires the `lines:write` scope and an `Idempotency-Key` header. Read endpoints require `lines:read`. Reseller keys only see the lines they own; admin keys see every line on the panel.

## Endpoints

| Endpoint | Method and path | What it does |
|---|---|---|
| [List lines](/docs/?page=xai-ref-lines-list) | `GET /lines` | Paginated list. Filters by owner, package and expiry. |
| [Create a line](/docs/?page=xai-ref-lines-create) | `POST /lines` | Creates a subscription against a package. Returns the credentials the customer will use to log in. |
| [Get a line](/docs/?page=xai-ref-lines-get) | `GET /lines/{id}` | Full record for a single line. |
| [Update a line](/docs/?page=xai-ref-lines-update) | `POST /lines/{id}/update` | Applies a partial update. Only the fields you send are touched. |
| [Enable a line](/docs/?page=xai-ref-lines-enable) | `POST /lines/{id}/enable` | Marks the line as active and allows logins. |
| [Disable a line](/docs/?page=xai-ref-lines-disable) | `POST /lines/{id}/disable` | Marks the line as inactive without deleting it. |
| [Renew a line](/docs/?page=xai-ref-lines-renew) | `POST /lines/{id}/renew` | Extends the expiry date by a number of months and charges the caller's billing budget. |
| [Reset password](/docs/?page=xai-ref-lines-reset-password) | `POST /lines/{id}/reset-password` | Generates a fresh password for the line. |
| [Delete a line](/docs/?page=xai-ref-lines-delete) | `POST /lines/{id}/delete` | Removes the line and its associations. |
| [List current connections](/docs/?page=xai-ref-lines-connections) | `GET /lines/{id}/connections` | Snapshot of the sessions currently open against this line. |