Luxor Documentation Hub Logo
Energy/API Documentation/Contracts

Update contract

Updates an existing contract. Cannot update a contract if it would violate active contract requirements for a site.

PATCH
/api/v1/energy/contracts/{contract_id}

Authorization

AuthorizationRequiredBearer <token>

In: header

Request Body

application/jsonRequired
site_idSite Id
origin_iso_nameOrigin Iso Name
origin_settlement_point_nameOrigin Settlement Point Name
typeContractType
subtypeContractSubtype
quantity_kwQuantity Kw
pricePrice
strike_quantity_kwStrike Quantity Kw
strike_priceStrike Price
start_timeStart Time
end_timeEnd Time
eligible_hoursEligible Hours
counterpartyCounterparty
commentsComments

Path Parameters

contract_idRequiredContract Id
Format: "uuid"
curl -X PATCH "https://app.luxor.tech/api/v1/energy/api/v1/energy/contracts/497f6eca-6276-4993-bfeb-53cbbbba6f08" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "counterparty": "Updated Provider",
    "eligible_hours": [
      7,
      8,
      9,
      10,
      11,
      12,
      13,
      14,
      15,
      16,
      17,
      18
    ],
    "end_time": "2025-12-31T23:59:59Z",
    "origin_iso_name": "ERCOT",
    "origin_settlement_point_name": "LZ_RAYBN",
    "price": "22.5",
    "quantity_kw": "40000.0",
    "site_id": "11110000-1111-1111-1111-111111111111",
    "start_time": "2025-01-01T00:00:00Z",
    "strike_price": "85.0",
    "strike_quantity_kw": "25000.0",
    "subtype": "FIXED",
    "type": "PPA"
  }'

Successful Response

{
  "site_id": "72771e6a-6f5e-4de4-a5b9-1266c4197811",
  "origin_iso_name": "string",
  "origin_settlement_point_name": "string",
  "type": "PPA",
  "subtype": "FIXED",
  "quantity_kw": "string",
  "price": "string",
  "strike_quantity_kw": "string",
  "strike_price": "string",
  "start_time": "2019-08-24T14:15:22Z",
  "end_time": "2019-08-24T14:15:22Z",
  "eligible_hours": [
    0
  ],
  "counterparty": "string",
  "comments": "string",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "url": "string"
}