---
title: "Update Team"
method: POST
path: "/api/metrics/developer/teams/update"
tags: ["Developer Metrics - Teams"]
---

# Update Team

`POST /api/metrics/developer/teams/update`

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.

## Request body

- UpdateTeamRequest
  - `platform` 'github' | 'gitlab' | 'bitbucket' | 'azure_devops' | 'azuredevops', required — Version control platform
  - `org` string, required — Organization, workspace, or group name on the platform
  - `github_base_url` string — Base URL for GitHub (use for GitHub Enterprise Server)
  - `gitlab_base_url` string — Base URL for GitLab (use for self-hosted GitLab instances)
  - `azure_devops_base_url` string — Base URL for Azure DevOps (use for Azure DevOps Server)
  - `bitbucket_base_url` string — Base URL for Bitbucket (use for Bitbucket Data Center/Server)
  - `team_id` string, uuid, required — ID of the team to update
  - `name` string — New team name
  - `description` string
  - `color` string
  - `team_leads` string[] — Array of team lead logins/emails. Replaces the entire list when provided.
  - `tags` string[]
  - `repositories` string[]

## Response `200`

Team updated

- object
  - `status` string
  - `message` string
  - `team` Team — A developer team with members, metadata, and repository assignments
    - `id` string, uuid — Unique team identifier
    - `name` string — Team name
    - `description` string — Team description
    - `color` string — Hex color for UI display
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `created_by` string
    - `team_leads` string[] — List of team lead identifiers
    - `members` TeamMember[]
      - `user_login` string — Unique login/email identifier of the member
      - `user_name` string — Display name of the member
      - `joined_at` string, date-time — When the member joined the team
      - `role` 'member' | 'lead' — Role within the team
    - `tags` string[]
    - `parent_team_id` string — Parent team ID for nested teams
    - `repositories` string[] — Assigned repository names
    - `is_active` boolean — Whether the team is active

## Other responses

- `400` — Bad request - missing or invalid parameters
- `401` — Unauthorized - missing, invalid, or insufficient access token
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.dev/codeant/apis/codeant-ai-api.md) · [All operations](https://skmtc.dev/codeant/apis/codeant-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/codeant/codeant-ai-api/revisions/d1eb7c083a39/schema)