---
title: "Lines"
description: "Endpoints for finding, creating, renewing, enabling, disabling, terminating and updating customer subscription lines in the OneStream compatibility dialect."
---

# Lines

Manage customer subscription lines using OneStream's opaque `line_id` UUIDs and `rid`-based idempotency. Every write requires the `lines:write` scope, and every `rid` retried with the same body replays the original response verbatim so retries are safe. Reseller keys only see the lines they own.

## Endpoints

| Endpoint | Method and path | What it does |
|---|---|---|
| [List lines](/docs/?page=os-ref-lines-list) | `GET /ext/lines` | Paginated list of subscription lines. |
| [Find line by username](/docs/?page=os-ref-lines-find) | `GET /ext/line/find` | Look up a single line by its username. |
| [Create line](/docs/?page=os-ref-lines-create) | `POST /ext/line/create` | Creates a subscription against a package with the minimal field set. |
| [Create line (advanced)](/docs/?page=os-ref-lines-create-advanced) | `POST /ext/line/create-advanced` | Creates a subscription with the full set of overridable fields. |
| [Renew line](/docs/?page=os-ref-line-renew) | `POST /ext/line/{uuid}/renew` | Extends the expiry date by a number of months and charges billing. |
| [Enable line](/docs/?page=os-ref-line-enable) | `POST /ext/line/{uuid}/enable` | Marks the line as active. |
| [Disable line](/docs/?page=os-ref-line-disable) | `POST /ext/line/{uuid}/disable` | Marks the line as inactive without deleting it. |
| [Terminate line](/docs/?page=os-ref-line-terminate) | `POST /ext/line/{uuid}/terminate` | Removes the line and its associations. |
| [Update line (advanced)](/docs/?page=os-ref-line-update-advanced) | `POST /ext/line/{uuid}/update-advanced` | Applies a partial update with the full set of overridable fields. |