# POST /api/{parent}/{id}/items > Line Items - Append a line to a document - **Endpoint:** `POST /api/{parent}/{id}/items` - **Group:** Line Items - **Since:** v1.0.0 - **Defined in:** `RestApi/Controllers/LineItemsController.php` ## Headers | Field | Type | Description | | --- | --- | --- | | `authtoken` | String | Authentication token, generated from admin area | ## Parameters | Field | Type | Required | Description | | --- | --- | --- | --- | | `parent` | String | yes | Document type owning the lines | | `id` | Number | yes | Parent document unique ID | | `title` | String | yes | Mandatory line title. A description is accepted instead. | | `description` | String | no | Optional line description | | `quantity` | Number | yes | Mandatory quantity, numeric | | `rate` | Number | yes | Mandatory unit rate, numeric | | `unit_type` | String | no | Optional unit type, maximum 20 characters | | `sort` | Number | no | Optional display order. Defaults to the end of the list. | | `item_id` | Number | no | Optional items library ID | | `taxable` | Number | no | Invoices only. 1 (default) or 0. | ## Request example ```bash curl -X POST "https://yoursite.com/index.php/api/1/123/items" \ -H "authtoken: YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "title": "...", "quantity": "...", "rate": "..." }' ``` ## Responses ### Success - Success-Response: ```json HTTP/1.1 201 Created { "status": 200, "messages": {"success": "The record has been saved."}, "id": 12 } ``` --- Part of the [REST API for RISE CRM](https://risecrm.themesic.com/apiguide/) documentation. Full page: https://risecrm.themesic.com/apiguide/line-items/create-line-item/