Luxor PlatformAPI DocumentationCommanderTickets

Reserve ticket part

Reserves qty units of a part for one linked device and returns the reservation. Calling it again for the same part and device sets the quantity rather than adding to it. The part must be at the ticket's site and the ticket must not be closed (400).

POST
/v2/commander/tickets/{ticket_id}/parts/reserve

Authorization

LuxorAPIKey
authorization<token>

Use your API key here.

In: header

Path Parameters

ticket_id*string

Ticket id (uuid).

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v2/commander/tickets/497f6eca-6276-4993-bfeb-53cbbbba6f08/parts/reserve" \  -H "Content-Type: application/json" \  -d '{    "part_id": "28c660ae-a12c-4da7-9243-03385b104cf1",    "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4",    "qty": 2  }'
{  "id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",  "part_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",  "name": "S21 Pro Hashboard",  "sku": "HB-0001",  "category": "hashboard",  "site_id": "b0a5fad8-1234-5678-9abc-def012345678",  "qty": 1,  "state": "reserved",  "created_at": "2026-10-01T10:00:00.000Z"}
{  "statusCode": 400,  "code": "FST_ERR_VALIDATION",  "error": "Bad Request",  "message": "body/end_date Required"}
{  "statusCode": 403,  "code": "7",  "error": "Forbidden",  "message": "[permission_denied] site_id does not belong to this workspace"}
{  "statusCode": 404,  "code": "5",  "error": "Not Found",  "message": "[not_found] agent not found"}