Create Team

Required scope: team:create

The API key creator must currently have team write access. color, when supplied, is a six-digit hexadecimal color; otherwise the workspace default is used.

Generated Reference

POST /public-api/publicapi.v1.Team/CreateTeam

Creates a team in the authenticated workspace.

Request CreateTeamRequest

Response CreateTeamResponse

CreateTeamRequest

Field	Type	Description
name	string
description	string
color	optional string	Six-digit hex color. The workspace default is used when omitted.

CreateTeamResponse

Field	Type
team	Team

Related Types

Team

Field	Type
id	string
name	string
description	string
color	string
member_count	int32
created_at	int64
updated_at	int64

Request

{
  "name": "Field Operations",
  "description": "Regional installation team",
  "color": "#2277AA"
}

This operation is not idempotent. Do not blindly retry after a timeout; first list teams to determine whether creation completed.