Membros do Projeto

REST API — Todos os endpoints requerem autenticação via Bearer token. Inclua Authorization: Bearer {token} em cada requisição. Os tokens são gerenciados em Configurações do GitScrum → API. Base URL: https://services.gitscrum.com — Todos os caminhos de requisição nesta documentação são relativos a esta URL base.

Recupere e gerencie membros atribuídos a um projeto. Use estes endpoints para preencher dropdowns de responsáveis, adicionar ou remover membros da equipe e construir dashboards de equipe.

Listar responsáveis do projeto

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

Retorna todos os membros atribuídos a um projeto (otimizado para dropdowns de responsáveis).

Parâmetros de caminho

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"

Resposta 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 membros do projeto

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

Retorna todos os membros com suas funções e permissões.

Parâmetros de caminho

Adicionar membro

POST /project-members/{project_slug}/members

Adiciona um usuário ao projeto.

Parâmetros de caminho

Corpo da requisição

Atualizar função do membro

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

Atualiza a função de um membro no projeto.

Parâmetros de caminho

Corpo da requisição

Remover membro

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

Remove um membro do projeto.

Parâmetros de caminho

Usuários disponíveis

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

Retorna membros do workspace que ainda não estão atribuídos ao projeto.

Parâmetros de caminho

Referência de campos

Casos de uso

• Dropdowns de responsáveis — Preencha seletores de atribuição de tarefas com membros do projeto
• Dashboards de equipe — Exiba composição da equipe e disponibilidade por fuso horário
• Menções — Construa autocomplete de @menção usando usernames
• Distribuição de carga — Combine com dados de tarefas para analisar a carga de trabalho da equipe