Projects

ReDesk AI › Projects

POST/v1/projects

Create a project from a template. Returns the id every other call refers to.

ParameterDescription

customer

body · string

Customer id the project belongs to.

template

body · string

SOP template to instantiate, e.g. tpl_rooftop_standard.

capacity_kw

body · number

Nameplate capacity. Must be greater than 0.

Response

{
  "id": "prj_8Q2Xk",
  "stage": "design",
  "capacity_kw": 42.5,
  "created": "2026-07-14T09:21:04Z"
}

GET/v1/projects/{id}

Retrieve one project, including its current stage and open SOP steps.

ParameterDescription

id

path · stringrequired

expand[]

query · string

sop_steps, proposals or milestones to inline them.

Response

{
  "id": "prj_8Q2Xk",
  "stage": "install",
  "open_steps": 3,
  "customer": "cus_8Q2Xk"
}

GET/v1/projects

List projects, most recently created first.

ParameterDescription

stage

query · string

Filter to one stage: design, install, commissioning, closed.

cursor

query · string

Pagination cursor from the previous page.

Response

{
  "data": [{ "id": "prj_8Q2Xk", "stage": "install" }],
  "has_more": true,
  "next_cursor": "cur_9Fm2"
}

The ReDesk API reference