GitScrum / Docs

Types de Tâche

Gérez les modèles de types de tâche. Listez, créez et mettez à jour les types comme Feature, Bug ou Amélioration.

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 types de tâche catégorisent les tâches au sein d'un projet — comme Feature, Bug, Improvement ou tout type personnalisé que vous définissez. Chaque type possède une couleur pour l'identification visuelle sur le tableau.

Lister les types de tâche

Retourne les types de tâche disponibles pour un projet.

GET /project-templates/type?company_slug={slug}&project_slug={slug}

Paramètres de requête

ParamètreTypeRequisDescription
company_slugstringOuiIdentifiant du workspace
project_slugstringOuiIdentifiant du projet

Exemple de requête

curl -X GET "https://services.gitscrum.com/project-templates/type?company_slug=acme&project_slug=web-app" \
  -H "Authorization: Bearer {token}"

Exemple de réponse

{
  "data": [
    {
      "id": 1,
      "title": "Feature",
      "color": "4A90D9",
      "position": 1
    },
    {
      "id": 2,
      "title": "Bug",
      "color": "E74C3C",
      "position": 2
    },
    {
      "id": 3,
      "title": "Improvement",
      "color": "F39C12",
      "position": 3
    }
  ]
}

Créer un type de tâche

Crée un nouveau type de tâche dans le projet.

POST /project-templates/type?company_slug={slug}&project_slug={slug}

Corps de la requête

ChampTypeRequisDescription
titlestringOuiNom du type (ex. : "Chore")
colorstringNonCouleur hex sans # (ex. : 9B59B6)

Exemple de requête

curl -X POST "https://services.gitscrum.com/project-templates/type?company_slug=acme&project_slug=web-app" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Chore",
    "color": "9B59B6"
  }'

Mettre à jour un type de tâche

Met à jour un type de tâche existant.

PUT /project-templates/type/{id}?company_slug={slug}&project_slug={slug}

Paramètres de chemin

ParamètreTypeDescription
idintegerID du type de tâche

Corps de la requête

ChampTypeRequisDescription
titlestringNonNom du type mis à jour
colorstringNonCouleur hex mise à jour sans #

Lister les niveaux d'effort

Retourne les niveaux d'effort/priorité configurés pour le projet.

GET /project-templates/effort?company_slug={slug}&project_slug={slug}

Exemple de réponse

{
  "data": [
    {
      "id": 1,
      "title": "Low",
      "color": "27AE60",
      "position": 1
    },
    {
      "id": 2,
      "title": "Medium",
      "color": "F39C12",
      "position": 2
    },
    {
      "id": 3,
      "title": "High",
      "color": "E74C3C",
      "position": 3
    }
  ]
}

Référence des champs

ChampTypeDescription
idintegerIdentifiant unique
titlestringNom du type ou de l'effort
colorstringCode couleur hex (sans #)
positionintegerOrdre d'affichage