What has been cooked lately

recipes.recipe.list_recent

GET/api/v1/households/{household_id}/queries/recipes.recipe.list_recent

Query
Rigel runs it

Recipes that have been cooked, most recently cooked first, then the ones never cooked, newest first. For suggesting something to cook or something new to try.

Parameters#

What has been cooked lately: parameters
Field	Description
`household_id`pathstringrequired	The household's ID.
`limit`queryintegeroptional	How many to return, 1–200. Defaults to 20. 1 to 200Default `20`

Response#

200 The answer.

What has been cooked lately: response fields
Field	Description
`items`array of objectsrequired
`items[].id`stringrequired	A recipe ID, such as rcp_01JC0000000000000000000000.
`items[].title`stringrequired	The title.
`items[].times_cooked`integerrequired	How many times it has been cooked.
`items[].last_cooked_on`string (date) or nullrequired	The last day it was cooked, or null if never.
`items[].never_cooked`booleanrequired	Whether it has never been cooked.

Errors#

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

What has been cooked lately: 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.

What has been cooked lately

Recipes cooked most recently come first, then the ones never cooked.

Request, curl

curl 'https://rigel.house/api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/queries/recipes.recipe.list_recent' \
  -H "Cookie: rigel_session=$RIGEL_SESSION"

Request, TypeScript

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

Request, HTTP

GET /api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/queries/recipes.recipe.list_recent 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_01M6V9CSEZPBC7996K26J79D3C

{
  "items": [
    {
      "id": "rcp_01M6V9CSDDZVYFRVFNA4X5BSMZ",
      "title": "Saturday pancakes",
      "times_cooked": 1,
      "last_cooked_on": "2026-11-06",
      "never_cooked": false
    },
    {
      "id": "rcp_01M6V9CSD8VZYF11AC568Y7QPZ",
      "title": "Tomato and white bean orzo",
      "times_cooked": 0,
      "last_cooked_on": null,
      "never_cooked": true
    }
  ]
}

For Rigel#

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