Miembros del Proyecto

REST API — Todos los endpoints requieren autenticación mediante Bearer token. Incluye Authorization: Bearer {token} en cada solicitud. Los tokens se gestionan en Configuración de GitScrum → API. Base URL: https://services.gitscrum.com — Todas las rutas de solicitud en esta documentación son relativas a esta URL base.

Recupera y gestiona miembros asignados a un proyecto. Usa estos endpoints para llenar selectores de asignados, agregar o eliminar miembros del equipo y construir dashboards de equipo.

Listar asignados del proyecto

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

Devuelve todos los miembros asignados a un proyecto (optimizado para selectores de asignados).

Parámetros de ruta

Parámetros de query

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"

Respuesta 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"
    }
  ]
}

Listar miembros del proyecto

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

Devuelve todos los miembros con sus roles y permisos.

Parámetros de ruta

Agregar miembro

POST /project-members/{project_slug}/members

Agrega un usuario al proyecto.

Parámetros de ruta

Cuerpo de la solicitud

Actualizar rol del miembro

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

Actualiza el rol de un miembro en el proyecto.

Parámetros de ruta

Cuerpo de la solicitud

Eliminar miembro

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

Elimina un miembro del proyecto.

Parámetros de ruta

Usuarios disponibles

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

Devuelve miembros del workspace que aún no están asignados al proyecto.

Parámetros de ruta

Referencia de campos

Casos de uso

• Selectores de asignados — Llena selectores de asignación de tareas con miembros del proyecto
• Dashboards de equipo — Muestra la composición del equipo y disponibilidad por zona horaria
• Menciones — Construye autocompletado de @menciones usando nombres de usuario
• Distribución de carga — Combina con datos de tareas para analizar la carga de trabajo del equipo