Get a team

One team, by its slug, as list_teams describes it.

GET/workspaces/{workspace}/teams/{team}

A secret team is found only by its own people and the workspace’s owners; anyone else is told it does not exist. Members of the workspace only.

404 for a team that does not exist, or a secret one you are not in, unless you are an owner.

Authentication: Required. Send an access token as Authorization: Bearer.
MCP tool: team with action get, and the same inputs
Scope: An access token needs workspace:read.

Path parameters

Name	Type	Required	Description
`workspace`	string	Yes	The workspace’s slug, e.g. “flagon-io”.
`team`	string	Yes	The team’s slug, as in its mention @workspace/slug, e.g. “backend”.

Example request

curl https://api.g1t.sh/workspaces/flagon-io/teams/backend \
  -H "Authorization: Bearer $G1T_TOKEN"

Example response

A successful request answers 200 with:

{
  "id": "team_01m52k8d3f7h1k5n9r3v7z1c5g",
  "workspace": "flagon-io",
  "slug": "backend",
  "name": "Backend",
  "description": "The API and the services behind it.",
  "visibility": "visible",
  "parent": {
    "slug": "engineering",
    "name": "Engineering"
  },
  "notify": true,
  "review_assignment": {
    "enabled": false,
    "algorithm": "round_robin",
    "count": 1,
    "skip_busy": false,
    "busy_at": 5,
    "include_child_teams": false,
    "excluded": [],
    "notify_team": false
  },
  "members_count": 4,
  "repos_count": 2,
  "child_teams_count": 1,
  "viewer_role": "maintainer",
  "can_manage": true,
  "created_at": "2026-10-06T15:02:11.480Z",
  "updated_at": "2026-10-06T15:02:11.480Z"
}

Errors

A failed request answers with one of these statuses and a body like {"error": {"code": "not_found", "message": "Repository not found."}}. See errors.

Status	Code	When
401	`unauthenticated`	A token is required, or the one sent is not valid.
403	`forbidden`	The token is valid but not allowed to do this, such as a member-only change or an agent token outside its repository.
404	`not_found`	It does not exist, or you cannot see it.
422	`invalid`	The input is not valid. `message` says which field and why.