---
title: "task_view | GraphQL API | Rolebase"
description: "Task View, represents a custom view of tasks in Rolebase. Task views allow users to organize and filter tasks flexibly, supporting different task management methodologies like Kanban or Scrum."
url: "https://rolebase.io/en/developers/graphql-api/task_view"
---

[Rolebase](/) ⟩[Developers](/en/developers) ⟩[GraphQL API](/en/developers/graphql-api)

# task\_view

Task View, represents a custom view of tasks in Rolebase. Task views allow users to organize and filter tasks flexibly, supporting different task management methodologies like Kanban or Scrum.

## Fields

Field

Type

Description

`id`

`uuid`

Unique identifier for the task view (auto-generated)

`orgId`

`uuid`

Reference to the organization

`key`

`String`

Unique key for the view within the organization (e.g., 'backlog', 'sprint')

`tasksIds`

`uuid[]`

Array of task IDs included in this view

## Relationships

### Object Relationships

*   `org` — The organization this task view belongs to

## Query Examples

### List Task Views

```
query GetTaskViews($orgId: uuid!) {  task_view(where: { orgId: { _eq: $orgId } }) {    id    key    tasksIds    org {      name    }  }}
```

### Get Tasks with a Specific View

```
query GetTasksWithView(  $orgId: uuid!  $filters: [task_bool_exp!]!  $taskViewKey: String!) {  org_by_pk(id: $orgId) {    tasks(where: { _and: $filters }) {      id      title      status      dueDate    }    task_views(where: { key: { _eq: $taskViewKey } }) {      id      key      tasksIds    }  }}
```

## Mutation Examples

### Create a Task View

```
mutation CreateTaskView {  insert_task_view_one(    object: {      orgId: "your-org-id"      key: "my-custom-view"      tasksIds: ["task-id-1", "task-id-2"]    }  ) {    id    key    tasksIds  }}
```

### Update a Task View

```
mutation UpdateTaskView {  update_task_view(    where: { orgId: { _eq: "your-org-id" }, key: { _eq: "my-custom-view" } }    _set: { tasksIds: ["task-id-1", "task-id-2", "task-id-3"] }  ) {    returning {      id      key      tasksIds    }  }}
```

## Permissions

Task view access is controlled based on organization membership:

*   All authenticated users can view task views
*   Organization members with **Member**, **Admin**, or **Owner** roles can create task views
*   Only the `tasksIds` field can be updated

The combination of `orgId` and `key` must be unique. Task IDs in the view must correspond to existing tasks in the organization. Views can be shared among organization members.