---
title: "Vue de tâche"
url: "https://rolebase.io/fr/api/task_view"
---

[Rolebase](/) ⟩ [Référence API](/fr/api)

 Référence API

# `task_view`

Représente une vue personnalisée des tâches dans Rolebase. Les vues de tâches permettent aux utilisateurs d'organiser et de filtrer les tâches de manière flexible, supportant différentes méthodologies de gestion comme Kanban ou Scrum.

## Champs

Champ

Type

Description

`id`

`uuid`

Identifiant unique de la vue de tâche (généré automatiquement)

`orgId`

`uuid`

Référence à l’organisation

`key`

`String`

Clé unique de la vue au sein de l’organisation (ex. : ‘backlog’, ‘sprint’)

`tasksIds`

`uuid[]`

Tableau d’identifiants de tâches incluses dans cette vue

## Relations

### Relations objet

*   `org` — L’organisation à laquelle cette vue de tâche appartient

## Exemples de requêtes

### Lister les vues de tâches

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

### Obtenir les tâches avec une vue spécifique

```
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
    }
  }
}
```

## Exemples de mutations

### Créer une vue de tâche

```
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
  }
}
```

### Mettre à jour une vue de tâche

```
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

L’accès aux vues de tâches est contrôlé en fonction de l’appartenance à l’organisation :

*   Tous les utilisateurs authentifiés peuvent consulter les vues de tâches
*   Les membres de l’organisation avec les rôles **Member**, **Admin** ou **Owner** peuvent créer des vues de tâches
*   Seul le champ `tasksIds` peut être mis à jour

La combinaison de `orgId` et `key` doit être unique. Les identifiants de tâches dans la vue doivent correspondre à des tâches existantes dans l’organisation. Les vues peuvent être partagées entre les membres de l’organisation.