Sign in
latestOpenAPI 3.0.3GitGuardian2026-08-201871515.0 MB

511b067cdcb1

Teams

Create a team

This endpoint allows you to create a team.

If you are using a personal access token, you need to have an access level superior or equal to manager.

If a personal access token is being used, the member is automatically added to the created team with permissions can_manage and full_access

post/v1/teams

Request body

idinteger
namestring required
descriptionstring nullable

team description.

is_globalboolean
gitguardian_urlstring
external_provider_idstring nullable

ID of the external provider associated to the team.

Example request

{
  "id": 3252,
  "name": "feature team A",
  "description": "Description of my team",
  "gitguardian_url": "https://dashboard.gitguardian.com/workspace/1/settings/user/teams/1",
  "external_provider_id": "123-456-7890"
}

Response

Team created

idinteger
namestring
descriptionstring nullable

team description.

is_globalboolean
gitguardian_urlstring
external_provider_idstring nullable

ID of the external provider associated to the team.

Example response

{
  "id": 3252,
  "name": "feature team A",
  "description": "Description of my team",
  "gitguardian_url": "https://dashboard.gitguardian.com/workspace/1/settings/user/teams/1",
  "external_provider_id": "123-456-7890"
}