Sign in

v1

latestOpenAPI 3.0.32026-07-26233989.2 KB
Developer Metrics - Teams

Update Team

Updates team metadata such as name, description, color, team leads, tags, or assigned repositories. Only include the fields you want to change - omitted fields are left unchanged.

post/api/metrics/developer/teams/update

Request body

platform'github' | 'gitlab' | 'bitbucket' | 'azure_devops' | 'azuredevops' required

Version control platform

orgstring required

Organization, workspace, or group name on the platform

github_base_urlstring

Base URL for GitHub (use for GitHub Enterprise Server)

gitlab_base_urlstring

Base URL for GitLab (use for self-hosted GitLab instances)

azure_devops_base_urlstring

Base URL for Azure DevOps (use for Azure DevOps Server)

bitbucket_base_urlstring

Base URL for Bitbucket (use for Bitbucket Data Center/Server)

team_idstring uuid required

ID of the team to update

namestring

New team name

descriptionstring
colorstring
team_leadsstring[]

Array of team lead logins/emails. Replaces the entire list when provided.

tagsstring[]
repositoriesstring[]

Example request

{
  "platform": "github",
  "org": "my-org",
  "github_base_url": "https://github.com",
  "gitlab_base_url": "https://gitlab.com",
  "azure_devops_base_url": "https://dev.azure.com",
  "bitbucket_base_url": "https://api.bitbucket.org/2.0",
  "team_leads": [
    "lead1@example.com",
    "lead2@example.com"
  ]
}

Response

Team updated

statusstring
messagestring

Example response

{
  "status": "success",
  "message": "Team updated successfully",
  "team": {
    "name": "Backend Team",
    "description": "Responsible for API services",
    "color": "#1570EF",
    "members": [
      {
        "user_login": "jane@example.com",
        "user_name": "Jane Doe",
        "role": "member"
      }
    ],
    "repositories": [
      "my-org/backend-api"
    ]
  }
}