---
title: "Update Order"
method: PUT
path: "/tenants/{tenant_id}/orders/{id}"
tags: ["Orders"]
---

# Update Order

`PUT /tenants/{tenant_id}/orders/{id}`

Update Order Phase

## Path parameters

- `id` string, required
- `tenant_id` string, uuid, required

## Request body

- object
  - `order` object, required
    - `phase` 'contacted' | 'scheduled' | 'attended' | 'nurturing', required

## Response `200`

Order phase successfully updated

- object
  - `order` object, required
    - `id` string, required — Unique ID identifying the order.
    - `customer_first_name` string, required — First name of the customer who the order belongs to
    - `customer_last_name` string, required — Last name of the customer who the order belongs to
    - `customer_email` string, required — Email of the customer who the order belongs to
    - `customer_phone` string, required — Phone of the customer who the order belongs to
    - `customer_address` string, required — Address of the customer who the order belongs to
    - `customer_address_components` object — Parsed components of the customer address
      - `street_address` string, nullable — Number and street of the customer address
      - `city` string, nullable — City of the customer address
      - `region` string, nullable — Region, state, or province of the customer address
      - `postal_code` string, nullable — Postal code of the customer address
      - `country` string, nullable — Country of the customer address
    - `phase` string, nullable — Phase in order lifecycle
    - `sold_by` string, nullable — Company that sold the order: aurora or installer
    - `energy_offset_percent` number, nullable — Energy offset percentage: 0.0 is no offset, 1.0 is 100% offset
    - `notes` string, nullable — Order notes
    - `utility_bill_url` string, nullable — Temporary download URL for the utility bill attached to this order. Valid for 12 hours. Nil if no utility bill is attached.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/aurorasolar/apis/sync-api.md) · [All operations](https://skmtc.net/aurorasolar/apis/sync-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aurorasolar/sync-api/revisions/5b41808d104d/schema)