Repairs and improvements under way

maintenance.project.list

GET/api/v1/households/{household_id}/queries/maintenance.project.list

Query
Rigel runs it

Projects with their status and counts. Without a status, the ones still going (planning, active, on hold); ask for done or cancelled to see finished ones.

Parameters#

Repairs and improvements under way: parameters
Field	Description
`household_id`pathstringrequired	The household's ID.
`status`queryone of: planning, active, on_hold, done, cancelledoptional	Only projects in this status. Leave out for planning, active and on hold.
`property_id`querystringoptional	Only this property's projects.

Response#

200 The answer.

Repairs and improvements under way: response fields
Field	Description
`items`array of objectsrequired
`items[].id`stringrequired	A maintenance project ID, such as mpj_01JC0000000000000000000000.
`items[].address`string or nullrequired	The web route that opens it.
`items[].title`stringrequired	What the project is.
`items[].goal`string or nullrequired	What done looks like.
`items[].kind`one of: repair, improvement, maintenance, otherrequired	repair, improvement, maintenance or other.
`items[].status`one of: planning, active, on_hold, done, cancelledrequired	planning, active, on_hold, done or cancelled.
`items[].property_id`stringrequired	A property ID, such as prp_01JC0000000000000000000000.
`items[].started_on`string or nullrequired	When it started.
`items[].finished_on`string or nullrequired	When it finished.
`items[].budget`integer or nullrequired	The budget in minor units of currency.
`items[].currency`string or nullrequired	The budget's currency. pattern ^[A-Z]{3}$
`items[].asset_count`integerrequired	Items it concerns.
`items[].open_issue_count`integerrequired	Problems it is working on that aren't resolved.
`items[].visit_count`integerrequired	Visits for it.

Errors#

Every error has the same envelope: error.code, error.message, error.details, error.recovery and error.request_id.

Repairs and improvements under way: errors
Status	Code	When
`400`	`validation_failed`	A field is missing, misspelled or out of range. details.fields lists each problem.
`401`	`unauthenticated`	The request has no valid session.
`404`	`not_found`	The household doesn't exist, or you aren't a member of it.

Examples#

These are real. Each was recorded from a sample household, the Okafors, running through the whole API when this site was built.

List the projects under way

Request, curl

curl 'https://rigel.house/api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/queries/maintenance.project.list' \
  -H "Cookie: rigel_session=$RIGEL_SESSION"

Request, TypeScript

const response = await fetch("https://rigel.house/api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/queries/maintenance.project.list", {
  headers: {
    Cookie: `rigel_session=${process.env.RIGEL_SESSION}`,
  },
});
const data = await response.json();

Request, HTTP

GET /api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/queries/maintenance.project.list HTTP/1.1
Host: rigel.house
Cookie: rigel_session=<your session>

Response, 200

HTTP/1.1 200 OK
Content-Type: application/json
X-Request-Id: req_01M6V9CT185JE0ZHPYHKVP536X

{
  "items": [
    {
      "id": "mpj_01M6V9CSZC4PE99PPRAQ7ASEZQ",
      "address": "/maintenance/projects/mpj_01M6V9CSZC4PE99PPRAQ7ASEZQ",
      "title": "Stop the basement window leak",
      "goal": "Dry basement walls before the spring rains.",
      "kind": "repair",
      "status": "active",
      "property_id": "prp_01M6V9CSTXS6P4CG6RNTNT60FA",
      "started_on": "2026-10-19",
      "finished_on": null,
      "budget": 150000,
      "currency": "USD",
      "asset_count": 0,
      "open_issue_count": 1,
      "visit_count": 0
    }
  ]
}

List finished projects

Without a status, only the ones still going come back.

Request, curl

curl 'https://rigel.house/api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/queries/maintenance.project.list?status=done' \
  -H "Cookie: rigel_session=$RIGEL_SESSION"

Request, TypeScript

const response = await fetch("https://rigel.house/api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/queries/maintenance.project.list?status=done", {
  headers: {
    Cookie: `rigel_session=${process.env.RIGEL_SESSION}`,
  },
});
const data = await response.json();

Request, HTTP

GET /api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/queries/maintenance.project.list?status=done HTTP/1.1
Host: rigel.house
Cookie: rigel_session=<your session>

Response, 200

HTTP/1.1 200 OK
Content-Type: application/json
X-Request-Id: req_01M6V9CT1A4E68NKVAJP2H7D3V

{
  "items": []
}

For Rigel#

Rigel's tool for this query is maintenance_project_list. Rigel runs this on its own, then says what it did. The agent guide has the rest.