The saved views

tasks.view.list

GET/api/v1/households/{household_id}/queries/tasks.view.list

Query
Rigel runs it

Every saved view, by name, with its mode and filters. The built-in Queue, Blocked and Browse views aren't listed.

Parameters#

The saved views: parameters
Field	Description
`household_id`pathstringrequired	The household's ID.

Response#

200 The answer.

The saved views: response fields
Field	Description
`items`array of objectsrequired
`items[].id`stringrequired	A task view ID, such as tvw_01JC0000000000000000000000.
`items[].name`stringrequired	No description.
`items[].mode`one of: queue, browserequired	queue: ready work by priority, leaving out done and (unless show_blocked) blocked tasks. browse: everything, done included.
`items[].filters`objectrequired	The view's filters, as `tasks.task.search` takes them.
`items[].filters.text`stringoptional	Words that must all appear in the title or description, ignoring case. at most 200 characters
`items[].filters.states`array, each one of: todo, doing, blocked, doneoptional	Only tasks in one of these states. at most 50 items
`items[].filters.assignee_person_id`stringoptional	Only tasks assigned to this person.
`items[].filters.priorities`array of numbers or nulloptional	Only tasks with one of these priorities. at most 50 items
`items[].filters.include_tag_ids`array of stringsoptional	Only tasks with at least one of these tags. at most 50 items
`items[].filters.exclude_tag_ids`array of stringsoptional	Leave out tasks with any of these tags. at most 50 items
`items[].filters.due_from`string (date)optional	Only tasks due on or after this date.
`items[].filters.due_to`string (date)optional	Only tasks due on or before this date.
`items[].filters.root_task_id`stringoptional	Only this task's subtasks, at any depth (a project's work).
`items[].filters.show_blocked`boolean or stringoptional	In a queue view, include blocked work too. Defaults to false.

Errors#

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

The saved views: 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 saved views

Request, curl

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

Request, TypeScript

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

Request, HTTP

GET /api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/queries/tasks.view.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_01M6V9CT5DS6NMADQM5TZG4JHK

{
  "items": [
    {
      "id": "tvw_01M6V9CT5BYG5MVM4XWVSYHNH2",
      "name": "Errands this month",
      "mode": "queue",
      "filters": {
        "include_tag_ids": [
          "tag_01M6V9CT2HYP2JXTPT7T98VN41"
        ],
        "due_to": "2026-12-07"
      }
    }
  ]
}

For Rigel#

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