Membres du Projet

Listez les membres et assignés du projet. Obtenez les détails de l'équipe incluant les rôles et avatars.

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.

Récupérez et gérez les membres assignés à un projet. Utilisez ces endpoints pour remplir les menus déroulants d'assignation, ajouter ou supprimer des membres de l'équipe et construire des tableaux de bord d'équipe.

Lister les assignés du projet

GET /project-members/{projectslug}/assignees?companyslug={slug}

Retourne tous les membres assignés à un projet (optimisé pour les menus déroulants d'assignation).

Paramètres de chemin

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

Paramètres de requête

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

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

Réponse 200 OK

{
  "data": [
    {
      "name": "Jane Smith",
      "username": "janesmith",
      "avatar": "https://avatar.url/jane.jpg",
      "headline": "Lead Developer",
      "timezone": "Europe/Lisbon"
    },
    {
      "name": "Alex Chen",
      "username": "alexchen",
      "avatar": "https://avatar.url/alex.jpg",
      "headline": "Frontend Engineer",
      "timezone": "America/New_York"
    }
  ]
}

Lister les membres du projet

GET /project-members/{projectslug}/members?companyslug={slug}

Retourne tous les membres avec leurs rôles et permissions.

Paramètres de chemin

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

Ajouter un membre

POST /project-members/{project_slug}/members

Ajoute un utilisateur au projet.

Paramètres de chemin

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

Corps de la requête

Champ	Type	Requis	Description
`company_slug`	string	Oui	Identifiant du workspace
`username`	string	Oui	Nom d'utilisateur à ajouter

Mettre à jour le rôle du membre

PUT /project-members/{project_slug}/members/{username}

Met à jour le rôle d'un membre dans le projet.

Paramètres de chemin

Paramètre	Type	Requis	Description
`project_slug`	string	Oui	Identifiant du projet
`username`	string	Oui	Nom d'utilisateur du membre

Corps de la requête

Champ	Type	Requis	Description
`company_slug`	string	Oui	Identifiant du workspace
`role`	string	Oui	Nouveau rôle

Supprimer un membre

DELETE /project-members/{projectslug}/members/{username}?companyslug={slug}

Supprime un membre du projet.

Paramètres de chemin

Paramètre	Type	Requis	Description
`project_slug`	string	Oui	Identifiant du projet
`username`	string	Oui	Nom d'utilisateur à supprimer

Utilisateurs disponibles

GET /project-members/{projectslug}/available-users?companyslug={slug}

Retourne les membres du workspace qui ne sont pas encore assignés au projet.

Paramètres de chemin

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

Référence des champs

Champ	Type	Description
`name`	string	Nom d'affichage du membre
`username`	string	Nom d'utilisateur unique
`avatar`	string	URL de l'image avatar
`headline`	string	Titre ou rôle du membre
`timezone`	string	Identifiant de fuseau horaire IANA

Cas d'utilisation

Menus déroulants d'assignation — Remplissez les sélecteurs d'assignation de tâches avec les membres du projet
Tableaux de bord d'équipe — Affichez la composition de l'équipe et la disponibilité par fuseau horaire
Mentions — Créez l'autocomplétion @mention en utilisant les noms d'utilisateur
Répartition de la charge — Combinez avec les données de tâches pour analyser la charge de travail de l'équipe