Tools

list_views

List saved views (list, board, table, gallery, calendar, feed) on a collection.

Last updated

list_views

List the saved views defined on a collection. Views encode filters, sorts, groupings, and the layout (list, board, table, gallery, calendar, feed) the human UI uses to render the collection.

Arguments

NameTypeRequiredDescription
collection_idstringyesThe ID of the collection whose views to list.

Returns

A JSON array of view summaries:

FieldTypeDescription
idstringStable view ID.
namestringDisplay name.
typestringLayout kind: list, board, table, gallery, calendar, feed.
isDefaultbooleanTrue if this is the default view for the collection.
positionnumberOrdering position in the UI.

Example

{
  "tool": "list_views",
  "arguments": {
    "collection_id": "col_a1b2c3"
  }
}

Sample response:

[
  { "id": "view_default", "name": "All", "type": "list", "isDefault": true, "position": 0 },
  { "id": "view_board", "name": "By status", "type": "board", "isDefault": false, "position": 1 }
]

See also