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

# Get Team

`POST /api/metrics/developer/teams/get`

Retrieves a single team by its ID, including full member list and repository assignments.

## Request body

- TeamIdRequest
  - `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

## Response `200`

Team details

- object
  - `status` 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)