GIgitguardian
Teams

Create a team

Changed on

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

  • Base URL
    https://api.gitguardian.com
  • URL
    https://api.gitguardian.com/v1/teams
  • Auth
    HTTP bearer

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.

external_provider_typestring nullable

Type 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",
  "external_provider_type": "okta"
}

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.

external_provider_typestring nullable

Type 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",
  "external_provider_type": "okta"
}

Changes

  • 9ae1cffd3970Revision changes
    • info

      added the new optional request property /

    • info

      added the optional property to the response with the status