# The rows a saved view shows: tasks or projects, per its resource GET`/v1/views/{view_id}/rows`[Token scope: `tasks:read`](https://developers.tasksmate.indrasol.com/guides/authentication/#scopes)[paginated list](https://developers.tasksmate.indrasol.com/guides/pagination-and-filters/) Request **curl** ```bash curl -X GET "https://tasksmate-fdfsarhnf5gacfb7.eastus-01.azurewebsites.net/v1/views//rows" \ -H "Authorization: Bearer $TASKSMATE_TOKEN" ``` **Python** ```python from tasksmate import TasksMate tm = TasksMate() # reads TASKSMATE_TOKEN for item in tm.views.rows(""): # follows next_cursor through every page print(item) ``` **tm** ```bash tm views rows V123456 --csv > rows.csv ``` Response 200 ```json { "data": [ { "project_id": "project-1234", "org_id": "org-1234", "sub_tasks": [ "task-5678" ], "dependencies": [ "task-4321" ], "title": "Implement Login", "description": "Implement OAuth2 login flow.", "status": "not_started", "assignee": "", "start_date": "2024-07-31", "due_date": "2024-08-01", "priority": "high", "task_type": "task", "tags": [ "backend", "auth" ], "type_data": {}, "metadata": [ { "field": "status", "new": "in_progress", "old": "not_started" } ], "created_by": "string", "updated_by": "string", "is_subtask": false, "bug_id": "B1234", "tracker_id": "TR1234", "restricted_to": [], "team_id": "string", "sprint_id": "SP12345", "milestone_id": "MS12345", "goal_id": "G12345", "task_id": "string", "created_at": "2026-09-25T12:00:00Z", "updated_at": "2026-09-25T12:00:00Z", "restricted_to_user_ids": [ "string" ], "comments": 0, "has_access": true, "has_edit_access": false, "section_id": "string", "section_position": 0 } ], "next_cursor": "string" } ``` The rows a saved view shows, as `{data, next_cursor}`: tasks for a `task` view, projects for a `project` view. - The view’s stored `query` runs like its list (`GET /v1/tasks` or `GET /v1/projects/{org_id}`), with **your** visibility: a team view opened by a guest returns the guest’s rows. - Only `limit`, `cursor` and `include_inaccessible` are accepted; any `filter[...]`, `sort_by`, `group_by`, `section_scope` or `show_all` here is a 400. ## Authorizations - **[bearerAuth](https://developers.tasksmate.indrasol.com/reference/#bearerauth)** - **[TasksMateToken](https://developers.tasksmate.indrasol.com/reference/#tasksmatetoken)** ## Parameters ### Path Parameters **view\_id** required _View Id_ string ### Query Parameters **limit** _Limit_ Page size, default 100; clamped to 1000. integer default: 100 \>= 1 Page size, default 100; clamped to 1000. **cursor** Any of: **string** string **null** null Opaque token from the previous page’s `next_cursor`. **include\_inaccessible** _Include Inaccessible_ Keep restricted rows with `has_access=false` (the list’s flag). boolean Keep restricted rows with `has_access=false` (the list’s flag). ### Header Parameters **If-None-Match** string An `ETag` you hold; unchanged → 304 with no body. ## Responses ### 200 Successful Response application/json Any of: **TaskListPage** _TaskListPage_ A page of `GET /v1/tasks`. `next_cursor` is opaque: send it back as `cursor`; null means the last page. `data` may be empty while `next_cursor` is set (every task on that page was restricted) — keep following the cursor. object **data** required _Data_ Array _TaskCardView_ Part of `TaskListPage`. object **project\_id** Any of: **string** string **null** null **org\_id** Any of: **string** string **null** null **sub\_tasks** Any of: **Array** Array **null** null **dependencies** Any of: **Array** Array **null** null **title** required _Title_ Task title string **description** Any of: **string** string **null** null **status** Any of: **TaskStatusEnum** _TaskStatusEnum_ A task’s status. `backlog` comes first wherever statuses are ordered (filters, grouping and the `status` sort); otherwise it is an ordinary status, accepted everywhere. string Allowed values: backlog not\_started in\_progress blocked completed archived on\_hold **null** null **assignee** Any of: **string** string **null** null **start\_date** Any of: **string** string format: date **null** null **due\_date** Any of: **string** string format: date **null** null **priority** Any of: **PriorityEnum** _PriorityEnum_ Priority enum for projects and tasks string Allowed values: high medium low none critical **null** null **task\_type** Any of: **TaskTypeEnum** _TaskTypeEnum_ The kind of task: `task`, `bug` or `agent`, in sort order (`sort_by=task_type`). - A label, never a permission. - A goal is not a task type but a container of a project’s tasks (`goal_id`): `task_type=goal` is refused on write (422) and in `filter[task_type]` (400). string Allowed values: task bug agent **null** null **tags** Any of: **Array** Array **null** null **type\_data** Any of: **object** object **_key_** additional properties any **null** null **metadata** Any of: **Array** Array object **_key_** additional properties any **null** null **created\_by** Any of: **string** string **null** null **updated\_by** Any of: **string** string **null** null **is\_subtask** Any of: **boolean** boolean **null** null **bug\_id** Any of: **string** string **null** null **tracker\_id** Any of: **string** string **null** null **restricted\_to** Any of: **Array** Array **null** null **team\_id** Any of: **string** string **null** null **sprint\_id** Any of: **string** string **null** null **milestone\_id** Any of: **string** string **null** null **goal\_id** Any of: **string** string **null** null **task\_id** required _Task Id_ string **created\_at** required Any of: **string** string format: date-time **null** null **updated\_at** required Any of: **string** string format: date-time **null** null **restricted\_to\_user\_ids** Any of: **Array** Array **null** null **comments** required Any of: **integer** integer **null** null **has\_access** Any of: **boolean** boolean **null** null **has\_edit\_access** Any of: **boolean** boolean **null** null **section\_id** Any of: **string** string **null** null **section\_position** Any of: **number** number **null** null **next\_cursor** Any of: **string** string **null** null **null** _Page\[ProjectCard\]_ Returned by `projects.list` and `views.rows`. object **data** required _Data_ Array _ProjectCard_ Simplified project representation for dashboard cards. object **org\_id** required _Org Id_ Organization ID (UUID) string **name** required _Name_ Project name string **description** Any of: **string** string **null** null **metadata** Any of: **object** object **_key_** additional properties any **null** null **status** Any of: **ProjectStatusEnum** _ProjectStatusEnum_ Project status enum string Allowed values: planning in\_progress not\_started active completed archived on\_hold blocked paused **null** null **priority** Any of: **PriorityEnum** _PriorityEnum_ Priority enum for projects and tasks string Allowed values: high medium low none critical **null** null **start\_date** Any of: **string** string format: date **null** null **end\_date** Any of: **string** string format: date **null** null **created\_by** Any of: **string** string **null** null **updated\_by** Any of: **string** string **null** null **is\_active** Any of: **boolean** boolean **null** null **delete\_reason** Any of: **string** string **null** null **owner** Any of: **string** string **null** null **team\_members** Any of: **Array** Array **null** null **visibility** Any of: **ProjectVisibilityEnum** _ProjectVisibilityEnum_ Who can see a project: `public` — every member of the organization; `private` — the project’s members and org admins. Also the organization’s default for new projects. string Allowed values: public private **null** null **team\_id** Any of: **string** string **null** null **project\_id** required _Project Id_ Project ID string **created\_at** Any of: **string** string format: date-time **null** null **updated\_at** Any of: **string** string format: date-time **null** null **tasks\_total** required _Tasks Total_ Total number of tasks in the project integer **tasks\_completed** required _Tasks Completed_ Number of completed tasks integer **progress\_percent** required _Progress Percent_ Project completion percentage, 0–100. number **leads** _Leads_ The project’s leads; optional, usually empty. Array _ProjectLeadOut_ One lead of a project: who, who set them, and when. A lead is distinct from the owner — the owner administers the project, a lead is accountable for delivering it. object **user\_id** required _User Id_ string **username** Any of: **string** string **null** null **assigned\_by** Any of: **string** string **null** null **assigned\_at** Any of: **string** string format: date-time **null** null **position** _Position_ The project’s place in the organization’s manual order. Lists sort by position, then name. integer 0 **next\_cursor** Any of: **string** string **null** null Example ```json { "data": [ { "project_id": "project-1234", "org_id": "org-1234", "sub_tasks": [ "task-5678" ], "dependencies": [ "task-4321" ], "title": "Implement Login", "description": "Implement OAuth2 login flow.", "status": "not_started", "assignee": "", "start_date": "2024-07-31", "due_date": "2024-08-01", "priority": "high", "task_type": "task", "tags": [ "backend", "auth" ], "type_data": {}, "metadata": [ { "field": "status", "new": "in_progress", "old": "not_started" } ], "created_by": "string", "updated_by": "string", "is_subtask": false, "bug_id": "B1234", "tracker_id": "TR1234", "restricted_to": [], "team_id": "string", "sprint_id": "SP12345", "milestone_id": "MS12345", "goal_id": "G12345", "task_id": "string", "created_at": "2026-09-25T12:00:00Z", "updated_at": "2026-09-25T12:00:00Z", "restricted_to_user_ids": [ "string" ], "comments": 0, "has_access": true, "has_edit_access": false, "section_id": "string", "section_position": 0 } ], "next_cursor": "string" } ``` ### 304 Not Modified — `If-None-Match` matched the current `ETag` (no body) ### 400 Bad request — a query parameter outside what the operation accepts (`invalid-parameter`) application/problem+json _Problem_ An RFC 9457 problem details object — the body of every error response. `detail` is the human-readable explanation; `request_id` identifies the request for support. object **type** required `about:blank` or a `urn:tasksmate:problem:*` identifier string Allowed values: about:blank urn:tasksmate:problem:validation urn:tasksmate:problem:invalid-parameter urn:tasksmate:problem:precondition-failed urn:tasksmate:problem:idempotency-key-reused urn:tasksmate:problem:idempotency-key-in-flight urn:tasksmate:problem:idempotency-key-invalid urn:tasksmate:problem:rate-limit urn:tasksmate:problem:internal urn:tasksmate:problem:token-invalid urn:tasksmate:problem:token-expired urn:tasksmate:problem:token-revoked urn:tasksmate:problem:insufficient-scope urn:tasksmate:problem:test-token-read-only urn:tasksmate:problem:token-policy urn:tasksmate:problem:url-refused **title** required string **status** required integer **detail** required Human-readable explanation (a string; for a 422, the list of validation errors) **instance** required string **request\_id** required string **errors** Structured failures: validation errors, or `{loc, msg, allowed}` for a bad parameter Array object Example ```json { "type": "about:blank", "title": "Bad request", "status": 400, "detail": "…", "instance": "/v1/…", "request_id": "9b2f1c1e-8c1a-4a53-9f9e-0f5f1f2d7c11" } ``` ### 401 Missing or invalid bearer token application/problem+json _Problem_ An RFC 9457 problem details object — the body of every error response. `detail` is the human-readable explanation; `request_id` identifies the request for support. object **type** required `about:blank` or a `urn:tasksmate:problem:*` identifier string Allowed values: about:blank urn:tasksmate:problem:validation urn:tasksmate:problem:invalid-parameter urn:tasksmate:problem:precondition-failed urn:tasksmate:problem:idempotency-key-reused urn:tasksmate:problem:idempotency-key-in-flight urn:tasksmate:problem:idempotency-key-invalid urn:tasksmate:problem:rate-limit urn:tasksmate:problem:internal urn:tasksmate:problem:token-invalid urn:tasksmate:problem:token-expired urn:tasksmate:problem:token-revoked urn:tasksmate:problem:insufficient-scope urn:tasksmate:problem:test-token-read-only urn:tasksmate:problem:token-policy urn:tasksmate:problem:url-refused **title** required string **status** required integer **detail** required Human-readable explanation (a string; for a 422, the list of validation errors) **instance** required string **request\_id** required string **errors** Structured failures: validation errors, or `{loc, msg, allowed}` for a bad parameter Array object Example ```json { "type": "about:blank", "title": "Missing or invalid bearer token", "status": 401, "detail": "…", "instance": "/v1/…", "request_id": "9b2f1c1e-8c1a-4a53-9f9e-0f5f1f2d7c11" } ``` ### 403 Authenticated, but not allowed application/problem+json _Problem_ An RFC 9457 problem details object — the body of every error response. `detail` is the human-readable explanation; `request_id` identifies the request for support. object **type** required `about:blank` or a `urn:tasksmate:problem:*` identifier string Allowed values: about:blank urn:tasksmate:problem:validation urn:tasksmate:problem:invalid-parameter urn:tasksmate:problem:precondition-failed urn:tasksmate:problem:idempotency-key-reused urn:tasksmate:problem:idempotency-key-in-flight urn:tasksmate:problem:idempotency-key-invalid urn:tasksmate:problem:rate-limit urn:tasksmate:problem:internal urn:tasksmate:problem:token-invalid urn:tasksmate:problem:token-expired urn:tasksmate:problem:token-revoked urn:tasksmate:problem:insufficient-scope urn:tasksmate:problem:test-token-read-only urn:tasksmate:problem:token-policy urn:tasksmate:problem:url-refused **title** required string **status** required integer **detail** required Human-readable explanation (a string; for a 422, the list of validation errors) **instance** required string **request\_id** required string **errors** Structured failures: validation errors, or `{loc, msg, allowed}` for a bad parameter Array object Example ```json { "type": "about:blank", "title": "Authenticated, but not allowed", "status": 403, "detail": "…", "instance": "/v1/…", "request_id": "9b2f1c1e-8c1a-4a53-9f9e-0f5f1f2d7c11" } ``` ### 404 Not found application/problem+json _Problem_ An RFC 9457 problem details object — the body of every error response. `detail` is the human-readable explanation; `request_id` identifies the request for support. object **type** required `about:blank` or a `urn:tasksmate:problem:*` identifier string Allowed values: about:blank urn:tasksmate:problem:validation urn:tasksmate:problem:invalid-parameter urn:tasksmate:problem:precondition-failed urn:tasksmate:problem:idempotency-key-reused urn:tasksmate:problem:idempotency-key-in-flight urn:tasksmate:problem:idempotency-key-invalid urn:tasksmate:problem:rate-limit urn:tasksmate:problem:internal urn:tasksmate:problem:token-invalid urn:tasksmate:problem:token-expired urn:tasksmate:problem:token-revoked urn:tasksmate:problem:insufficient-scope urn:tasksmate:problem:test-token-read-only urn:tasksmate:problem:token-policy urn:tasksmate:problem:url-refused **title** required string **status** required integer **detail** required Human-readable explanation (a string; for a 422, the list of validation errors) **instance** required string **request\_id** required string **errors** Structured failures: validation errors, or `{loc, msg, allowed}` for a bad parameter Array object Example ```json { "type": "about:blank", "title": "Not found", "status": 404, "detail": "…", "instance": "/v1/…", "request_id": "9b2f1c1e-8c1a-4a53-9f9e-0f5f1f2d7c11" } ``` ### 409 Conflict (a duplicate, or an `Idempotency-Key` still in flight) application/problem+json _Problem_ An RFC 9457 problem details object — the body of every error response. `detail` is the human-readable explanation; `request_id` identifies the request for support. object **type** required `about:blank` or a `urn:tasksmate:problem:*` identifier string Allowed values: about:blank urn:tasksmate:problem:validation urn:tasksmate:problem:invalid-parameter urn:tasksmate:problem:precondition-failed urn:tasksmate:problem:idempotency-key-reused urn:tasksmate:problem:idempotency-key-in-flight urn:tasksmate:problem:idempotency-key-invalid urn:tasksmate:problem:rate-limit urn:tasksmate:problem:internal urn:tasksmate:problem:token-invalid urn:tasksmate:problem:token-expired urn:tasksmate:problem:token-revoked urn:tasksmate:problem:insufficient-scope urn:tasksmate:problem:test-token-read-only urn:tasksmate:problem:token-policy urn:tasksmate:problem:url-refused **title** required string **status** required integer **detail** required Human-readable explanation (a string; for a 422, the list of validation errors) **instance** required string **request\_id** required string **errors** Structured failures: validation errors, or `{loc, msg, allowed}` for a bad parameter Array object Example ```json { "type": "about:blank", "title": "Conflict (a duplicate, or an `Idempotency-Key` still in flight)", "status": 409, "detail": "…", "instance": "/v1/…", "request_id": "9b2f1c1e-8c1a-4a53-9f9e-0f5f1f2d7c11" } ``` ### 412 `If-Match` does not match the current `ETag` application/problem+json _Problem_ An RFC 9457 problem details object — the body of every error response. `detail` is the human-readable explanation; `request_id` identifies the request for support. object **type** required `about:blank` or a `urn:tasksmate:problem:*` identifier string Allowed values: about:blank urn:tasksmate:problem:validation urn:tasksmate:problem:invalid-parameter urn:tasksmate:problem:precondition-failed urn:tasksmate:problem:idempotency-key-reused urn:tasksmate:problem:idempotency-key-in-flight urn:tasksmate:problem:idempotency-key-invalid urn:tasksmate:problem:rate-limit urn:tasksmate:problem:internal urn:tasksmate:problem:token-invalid urn:tasksmate:problem:token-expired urn:tasksmate:problem:token-revoked urn:tasksmate:problem:insufficient-scope urn:tasksmate:problem:test-token-read-only urn:tasksmate:problem:token-policy urn:tasksmate:problem:url-refused **title** required string **status** required integer **detail** required Human-readable explanation (a string; for a 422, the list of validation errors) **instance** required string **request\_id** required string **errors** Structured failures: validation errors, or `{loc, msg, allowed}` for a bad parameter Array object Example ```json { "type": "about:blank", "title": "`If-Match` does not match the current `ETag`", "status": 412, "detail": "…", "instance": "/v1/…", "request_id": "9b2f1c1e-8c1a-4a53-9f9e-0f5f1f2d7c11" } ``` ### 422 The body or query did not validate (`validation`), or an `Idempotency-Key` was reused application/problem+json _Problem_ An RFC 9457 problem details object — the body of every error response. `detail` is the human-readable explanation; `request_id` identifies the request for support. object **type** required `about:blank` or a `urn:tasksmate:problem:*` identifier string Allowed values: about:blank urn:tasksmate:problem:validation urn:tasksmate:problem:invalid-parameter urn:tasksmate:problem:precondition-failed urn:tasksmate:problem:idempotency-key-reused urn:tasksmate:problem:idempotency-key-in-flight urn:tasksmate:problem:idempotency-key-invalid urn:tasksmate:problem:rate-limit urn:tasksmate:problem:internal urn:tasksmate:problem:token-invalid urn:tasksmate:problem:token-expired urn:tasksmate:problem:token-revoked urn:tasksmate:problem:insufficient-scope urn:tasksmate:problem:test-token-read-only urn:tasksmate:problem:token-policy urn:tasksmate:problem:url-refused **title** required string **status** required integer **detail** required Human-readable explanation (a string; for a 422, the list of validation errors) **instance** required string **request\_id** required string **errors** Structured failures: validation errors, or `{loc, msg, allowed}` for a bad parameter Array object Example ```json { "type": "about:blank", "title": "The body or query did not validate (`validation`), or an `Idempotency-Key` was reused", "status": 422, "detail": "…", "instance": "/v1/…", "request_id": "9b2f1c1e-8c1a-4a53-9f9e-0f5f1f2d7c11" } ``` ### 429 An access token over its per-minute limit (`rate-limit`; see `Retry-After`) application/problem+json _Problem_ An RFC 9457 problem details object — the body of every error response. `detail` is the human-readable explanation; `request_id` identifies the request for support. object **type** required `about:blank` or a `urn:tasksmate:problem:*` identifier string Allowed values: about:blank urn:tasksmate:problem:validation urn:tasksmate:problem:invalid-parameter urn:tasksmate:problem:precondition-failed urn:tasksmate:problem:idempotency-key-reused urn:tasksmate:problem:idempotency-key-in-flight urn:tasksmate:problem:idempotency-key-invalid urn:tasksmate:problem:rate-limit urn:tasksmate:problem:internal urn:tasksmate:problem:token-invalid urn:tasksmate:problem:token-expired urn:tasksmate:problem:token-revoked urn:tasksmate:problem:insufficient-scope urn:tasksmate:problem:test-token-read-only urn:tasksmate:problem:token-policy urn:tasksmate:problem:url-refused **title** required string **status** required integer **detail** required Human-readable explanation (a string; for a 422, the list of validation errors) **instance** required string **request\_id** required string **errors** Structured failures: validation errors, or `{loc, msg, allowed}` for a bad parameter Array object Example ```json { "type": "about:blank", "title": "An access token over its per-minute limit (`rate-limit`; see `Retry-After`)", "status": 429, "detail": "…", "instance": "/v1/…", "request_id": "9b2f1c1e-8c1a-4a53-9f9e-0f5f1f2d7c11" } ``` ### 500 Unexpected server error — quote `request_id` application/problem+json _Problem_ An RFC 9457 problem details object — the body of every error response. `detail` is the human-readable explanation; `request_id` identifies the request for support. object **type** required `about:blank` or a `urn:tasksmate:problem:*` identifier string Allowed values: about:blank urn:tasksmate:problem:validation urn:tasksmate:problem:invalid-parameter urn:tasksmate:problem:precondition-failed urn:tasksmate:problem:idempotency-key-reused urn:tasksmate:problem:idempotency-key-in-flight urn:tasksmate:problem:idempotency-key-invalid urn:tasksmate:problem:rate-limit urn:tasksmate:problem:internal urn:tasksmate:problem:token-invalid urn:tasksmate:problem:token-expired urn:tasksmate:problem:token-revoked urn:tasksmate:problem:insufficient-scope urn:tasksmate:problem:test-token-read-only urn:tasksmate:problem:token-policy urn:tasksmate:problem:url-refused **title** required string **status** required integer **detail** required Human-readable explanation (a string; for a 422, the list of validation errors) **instance** required string **request\_id** required string **errors** Structured failures: validation errors, or `{loc, msg, allowed}` for a bad parameter Array object Example ```json { "type": "about:blank", "title": "Unexpected server error", "status": 500, "detail": "…", "instance": "/v1/…", "request_id": "9b2f1c1e-8c1a-4a53-9f9e-0f5f1f2d7c11" } ``` --- Source: https://developers.tasksmate.indrasol.com/reference/operations/viewsrows/