Workflows

Obtenez les colonnes de workflow du projet (états du tableau Kanban). Utilisez les IDs de workflow pour déplacer les tâches entre colonnes.

REST API — Tous les endpoints nécessitent une authentification par Bearer token. Incluez Authorization: Bearer {token} dans chaque requête. Les tokens sont gérés dans Paramètres GitScrum → API. Base URL: https://services.gitscrum.com — Tous les chemins de requête dans cette documentation sont relatifs à cette URL de base.

Les workflows définissent les colonnes du tableau Kanban d'un projet. Chaque colonne représente un état de tâche (ex. : Backlog, In Progress, Done). Utilisez les IDs de workflow pour déplacer les tâches entre colonnes.

Lister les workflows

GET /projects-workflows?companyslug={slug}&projectslug={slug}

Retourne les colonnes du tableau Kanban d'un projet.

Paramètres de requête

Paramètre	Type	Requis	Description
`company_slug`	string	Oui	Identifiant du workspace
`project_slug`	string	Oui	Identifiant du projet

curl -X GET "https://services.gitscrum.com/projects-workflows?company_slug=acme-corp&project_slug=web-platform" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

Réponse 200 OK

{
  "data": [
    {
      "id": 1,
      "slug": "backlog",
      "title": "Backlog",
      "color": "#6B7280",
      "state": 0,
      "position": 1,
      "default": true
    },
    {
      "id": 2,
      "slug": "in-progress",
      "title": "In Progress",
      "color": "#3B82F6",
      "state": 0,
      "position": 2,
      "default": false
    },
    {
      "id": 3,
      "slug": "in-review",
      "title": "In Review",
      "color": "#F59E0B",
      "state": 0,
      "position": 3,
      "default": false
    },
    {
      "id": 4,
      "slug": "done",
      "title": "Done",
      "color": "#10B981",
      "state": 1,
      "position": 4,
      "default": false
    }
  ]
}

Créer une colonne de workflow

POST /projects-workflows

Ajoute une nouvelle colonne au tableau du projet.

Corps de la requête

Champ	Type	Requis	Description
`title`	string	Oui	Nom de la colonne
`company_slug`	string	Oui	Identifiant du workspace
`project_slug`	string	Oui	Identifiant du projet
`color`	string	Non	Couleur hexadécimale sans `#`
`state`	integer	Non	`0` = ouvert, `1` = terminé

curl -X POST https://services.gitscrum.com/projects-workflows \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "QA Review",
    "company_slug": "acme-corp",
    "project_slug": "web-platform",
    "color": "F59E0B",
    "state": 0
  }'

Mettre à jour une colonne de workflow

PUT /projects-workflows/{id}

Met à jour une colonne de workflow.

Paramètres de chemin

Paramètre	Type	Requis	Description
`id`	integer	Oui	ID de la colonne de workflow

Corps de la requête

Champ	Type	Requis	Description
`company_slug`	string	Oui	Identifiant du workspace
`project_slug`	string	Oui	Identifiant du projet
`title`	string	Non	Nom de la colonne
`color`	string	Non	Couleur hexadécimale sans `#`

Mettre à jour la limite WIP

PUT /projects-workflows/{id}/wip

Définit la limite de travail en cours pour une colonne.

Paramètres de chemin

Paramètre	Type	Requis	Description
`id`	integer	Oui	ID de la colonne de workflow

Corps de la requête

Champ	Type	Requis	Description
`wip`	integer	Oui	Maximum de tâches autorisées (0 = illimité)
`company_slug`	string	Oui	Identifiant du workspace
`project_slug`	string	Oui	Identifiant du projet

Supprimer une colonne de workflow

DELETE /projects-workflows/{id}?companyslug={slug}&projectslug={slug}

Supprime une colonne du tableau du projet. Les tâches dans la colonne sont déplacées vers la colonne par défaut.

Paramètres de chemin

Paramètre	Type	Requis	Description
`id`	integer	Oui	ID de la colonne de workflow

Référence des champs

Champ	Type	Description
`id`	integer	ID de la colonne de workflow — utilisé pour déplacer les tâches
`slug`	string	Identifiant de colonne URL-friendly
`title`	string	Nom d'affichage de la colonne
`color`	string	Couleur de la colonne (hex)
`state`	integer	`0` = ouvert, `1` = terminé
`position`	integer	Position de la colonne sur le tableau (1 = plus à gauche)
`default`	boolean	Si c'est la colonne par défaut pour les nouvelles tâches

Déplacer des tâches entre colonnes

Utilisez l'id du workflow pour mettre à jour la colonne d'une tâche :

curl -X PUT https://services.gitscrum.com/tasks/{task_uuid} \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "company_slug": "acme-corp",
    "project_slug": "web-platform",
    "workflow_id": 2
  }'

Ceci déplace la tâche vers la colonne "In Progress" (ID 2).

Les IDs de workflow sont spécifiques au projet. Récupérez toujours la liste des workflows du projet cible avant de déplacer des tâches.