---
title: "Create EagleView Design Request"
method: POST
path: "/tenants/{tenant_id}/design_requests/eagleview"
tags: ["Design Requests"]
---

# Create EagleView Design Request

`POST /tenants/{tenant_id}/design_requests/eagleview`

Create a new EagleView design request.

---

Use the latitude/longitude attributes to set the project marker on top of the building you would like modeled. If latitude/longitude are not explicitly provided in this request, the latitude/longitude values of the project will be used. However, the project latitude/longitude may not represent the building that should have the solar installation.

## Path parameters

- `tenant_id` string, uuid, required

## Request body

- object
  - `eagleview_design_request` object — EagleView design request to create.
    - `project_id` string, uuid, required — Unique ID identifying the project that the EagleView design request belongs to.
    - `latitude` number, double — Latitude of the site. If both latitude and longitude are not set (or both are null), the project coordinates will be used. This determines the building to be modeled. Rejected if only one (lat or long) is set.
    - `longitude` number, double — Longitude of the site. If both latitude and longitude are not set (or both are null), the project coordinates will be used. This determines the building to be modeled. Rejected if only one (lat or long) is set.
    - `auto_accept` boolean — Whether or not it should be auto-accepted upon completion. Defaults to false.
    - `skip_availability_check` boolean — Whether to skip verification of EagleView Powered Model availability prior to order placement. If false, a pre-check will verify feature availability at the requested location. Unsupported locations will return an error, and an EagleView design request will not be created. If true, this pre-check will be skipped. An EagleView design request will be created and subsequent updates will be later communicated via `design_status` changes. Defaults to false.
    - `source_design_id` string, uuid — Unique ID identifying a design to merge with the EagleView model. - If provided: - With auto_accept=true: Automatically merges completed EagleView model with this design - With auto_accept=false: Will merge with this design when manually accepted - If not provided: - With auto_accept=true: Attempts to merge with the latest sold milestone design (error if it does not exist) - With auto_accept=false: Creates a standalone design when accepted Defaults to null.

## Response `200`

EagleView design request successfully created.

- object
  - `eagleview_design_request` object
    - `id` string, uuid — Unique ID identifying the EagleView design request.
    - `project_id` string, uuid — Unique ID identifying the project that the EagleView design request belongs to.
    - `tenant_id` string, uuid — Unique ID identifying the tenant that the EagleView design request is part of.
    - `design_status` 'requested' | 'completed' | 'design_failed' | 'accepted' | 'in_dispute' — The status of the EagleView design request
    - `latitude` number, double — Latitude of the building to be modeled.
    - `longitude` number, double — Longitude of the building to be modeled.
    - `design_id` string, uuid — Unique ID identifying the design that the EagleView design request corresponds to. Only populated if the EagleView design request has been accepted.
    - `auto_accept` boolean — Whether or not it should be auto-accepted upon completion. Defaults to false.
    - `auto_accepted` boolean — Whether or not it has been auto-accepted. Starts as false, then moves to true upon auto-accept.
    - `source_design_id` string, uuid — Unique ID identifying a design to merge with the EagleView model. - If provided: - With auto_accept=true: Automatically merges completed EagleView model with this design - With auto_accept=false: Will merge with this design when manually accepted - If not provided: - With auto_accept=true: Attempts to merge with the latest sold milestone design (error if it does not exist) - With auto_accept=false: Creates a standalone design when accepted Defaults to null.
    - `created_at` string, date-time — Timestamp of when the EagleView design request was created in UTC.
    - `updated_at` string, date-time — Timestamp of when the EagleView design request was last updated in UTC.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `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)