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.
- Escopo
projects:read- Permissão
- Ver o módulo
- Tool do MCP
projects_views_listNa superfície completa; na compacta,mb_execute_operationcomid: "projects.views.list".
Custo declarado: até 204 leituras e 0 escritas por chamada (contam na cota diária).
Parâmetros
project_idstringrotaThe project's id (from projects.projects.list, or the project_id that projects.projects.create returns).
limitintegerqueryopcionalHow many items this page brings at most (see the maximum and the default in the schema).
Padrão: 50
cursorstringqueryopcionalThe next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.
Resposta
dataarray<object>has_morebooleannext_cursorstringErros
Exemplo
curl "https://api.mb-suite.com/v1/projects/{project_id}/views" \
-H "Authorization: Bearer $MB_API_KEY"Testar com a sua API key de teste
Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.
curl "https://api.mb-suite.com/v1/projects/{project_id}/views" \
-H "Authorization: Bearer $MB_TEST_KEY"