GitScrum / Docs

Project Members

List project members and assignees. Get team member details including roles and avatars.

REST API — All endpoints require authentication via Bearer token. Include Authorization: Bearer {token} in every request. Tokens are managed in GitScrum Settings → API. Base URL: https://services.gitscrum.com — All request paths in this documentation are relative to this base URL.

Retrieve and manage members assigned to a project. Use these endpoints to populate assignee dropdowns, add or remove team members, and build team dashboards.

List project assignees

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

Returns all members assigned to a project (optimized for assignee dropdowns).

Path parameters

ParameterTypeRequiredDescription
project_slugstringYesProject identifier

Query parameters

ParameterTypeRequiredDescription
company_slugstringYesWorkspace identifier
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"

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

List project members

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

Returns all members with their roles and permissions.

Path parameters

ParameterTypeRequiredDescription
project_slugstringYesProject identifier

Add member

POST /project-members/{project_slug}/members

Adds a user to the project.

Path parameters

ParameterTypeRequiredDescription
project_slugstringYesProject identifier

Request body

FieldTypeRequiredDescription
company_slugstringYesWorkspace identifier
usernamestringYesUsername to add

Update member role

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

Updates a member's role in the project.

Path parameters

ParameterTypeRequiredDescription
project_slugstringYesProject identifier
usernamestringYesTarget username

Request body

FieldTypeRequiredDescription
company_slugstringYesWorkspace identifier
rolestringYesNew role

Remove member

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

Removes a member from the project.

Path parameters

ParameterTypeRequiredDescription
project_slugstringYesProject identifier
usernamestringYesUsername to remove

Available users

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

Returns workspace members who are not yet assigned to the project.

Path parameters

ParameterTypeRequiredDescription
project_slugstringYesProject identifier

Field reference

FieldTypeDescription
namestringMember display name
usernamestringUnique username handle
avatarstringAvatar image URL
headlinestringMember title or role
timezonestringIANA timezone identifier

Use cases

  • Assignee dropdowns — Populate task assignment selectors with project members
  • Team dashboards — Display team composition and availability by timezone
  • Mentions — Build @mention autocomplete using usernames
  • Workload distribution — Combine with task data to analyze team workload