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.
- Alcance
projects:read- Permiso
- Ver el módulo
- Tool del MCP
projects_views_listEn la superficie completa; en la compacta,mb_execute_operationconid: "projects.views.list".
Costo declarado: hasta 204 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).
Parámetros
project_idstringrutaThe 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).
Por defecto: 50
cursorstringqueryopcionalThe next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.
Respuesta
dataarray<object>has_morebooleannext_cursorstringErrores
Ejemplo
curl "https://api.mb-suite.com/v1/projects/{project_id}/views" \
-H "Authorization: Bearer $MB_API_KEY"Probar con tu API key de prueba
Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.
curl "https://api.mb-suite.com/v1/projects/{project_id}/views" \
-H "Authorization: Bearer $MB_TEST_KEY"