List the saved views of a project
projects.views.list
Lists the saved views of a project's sheet (its tabs: Table, Board and the ones the team saved), in their tab order, with their layout (table or board), grouping (group_by: status, assignee, none or cf:<field slug>), sort, visible columns and filter. Columns and sort fields are named as projects.items.list names the item's fields (title, task_count, status, assignee_ids, start_date, due_date, order) or cf:<field slug> for a custom field. Use it to learn how the team slices a project; the items themselves come from projects.items.list. Views are presentation settings: read-only through the API (they are created and edited on the screen). Not found if the project is private to other people. Requires view access to Projects.
- Scope
projects:read- Permission
- View the module
- MCP tool
projects_views_listOn the full surface; on the compact one,mb_execute_operationwithid: "projects.views.list".
Declared cost: up to 204 reads and 0 writes per call (they count against the daily quota).
Parameters
project_idstringpathThe project's id (from projects.projects.list, or the project_id that projects.projects.create returns).
limitintegerqueryoptionalHow many items this page brings at most (see the maximum and the default in the schema).
Default: 50
cursorstringqueryoptionalThe next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.
Response
dataarray<object>has_morebooleannext_cursorstringErrors
Example
curl "https://api.mb-suite.com/v1/projects/{project_id}/views" \
-H "Authorization: Bearer $MB_API_KEY"Try it with your test API key
With a test API key the request always goes to your practice organization: example data you can reset.
curl "https://api.mb-suite.com/v1/projects/{project_id}/views" \
-H "Authorization: Bearer $MB_TEST_KEY"