Labels

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 labels aident à catégoriser et filtrer les tâches à travers les projets. Gérez les labels au niveau du workspace et attachez-les à des tâches individuelles.

Lister les labels

GET /projects-labels?company_slug={slug}

Retourne tous les labels du workspace.

Paramètres de requête

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

Réponse 200 OK

{
  "data": [
    {
      "id": 1,
      "slug": "bug",
      "title": "Bug",
      "color": "EF4444"
    },
    {
      "id": 2,
      "slug": "feature",
      "title": "Feature",
      "color": "3B82F6"
    },
    {
      "id": 3,
      "slug": "urgent",
      "title": "Urgent",
      "color": "F59E0B"
    }
  ]
}

Créer un label

POST /projects-labels?company_slug={slug}

Crée un nouveau label dans le workspace.

Paramètres de requête

Corps de la requête

curl -X POST "https://services.gitscrum.com/projects-labels?company_slug=acme-corp" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Design",
    "color": "8B5CF6"
  }'

Réponse 201 Created

{
  "data": {
    "id": 4,
    "slug": "design",
    "title": "Design",
    "color": "8B5CF6"
  }
}

Mettre à jour un label

PUT /projects-labels/{slug}?company_slug={slug}

Met à jour un label existant.

Paramètres de chemin

Paramètres de requête

Corps de la requête

curl -X PUT "https://services.gitscrum.com/projects-labels/design?company_slug=acme-corp" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "UI Design",
    "color": "7C3AED"
  }'

Réponse 200 OK

{
  "data": {
    "id": 4,
    "slug": "design",
    "title": "UI Design",
    "color": "7C3AED"
  }
}

Supprimer un label

DELETE /projects-labels/{slug}?company_slug={slug}

Supprime définitivement un label et le retire de toutes les tâches.

Paramètres de chemin

Paramètres de requête

curl -X DELETE "https://services.gitscrum.com/projects-labels/design?company_slug=acme-corp" \
  -H "Authorization: Bearer {token}"

Attacher un label

POST /projects-labels/{labelslug}/attach?companyslug={slug}&project_slug={slug}

Attache un label à une tâche. Sans effet si déjà attaché.

Paramètres de chemin

Paramètres de requête

Corps de la requête

curl -X POST "https://services.gitscrum.com/projects-labels/feature/attach?company_slug=acme-corp&project_slug=web-platform" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "task_uuid": "task-uuid-abc123"
  }'

Détacher un label

DELETE /projects-labels/{labelslug}/detach?companyslug={slug}&project_slug={slug}

Retire un label d'une tâche. Sans effet si non attaché.

Paramètres de chemin

Paramètres de requête

Corps de la requête

curl -X DELETE "https://services.gitscrum.com/projects-labels/feature/detach?company_slug=acme-corp&project_slug=web-platform" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "task_uuid": "task-uuid-abc123"
  }'

Référence des champs