TeamResource

Create a team

Create a team in an organization.

Required API key permissions

  • Scope: teams:create
  • Accepted key types: organization API key (org-wide), organization API key (team-scoped), personal access token (org-wide), personal access token (team-scoped)
  • Access: Operates on a single organization. Pass organizationId when your API key spans multiple organizations.
  • Required organization role (user-linked keys only): Administrator
  • Organization API keys are not subject to organization or team role checks.
post/api/public/v1/team

Request

Query parameters

organizationIdstring uuid
provisionboolean

When true, the created or updated resource is marked as provisioned and becomes read-only in the web UI. Defaults to false on create. On update, omitting this parameter preserves the existing provisioned state. Not available for personal access tokens.

Request body

displayNamestring required
timeZoneIdstring required
labelsstring[] nullable

Response

OK

idstring uuid
isProvisionedboolean
displayNamestring nullable
timeZoneIdstring nullable
labelsstring[] nullable

Changes

No recorded changes to this operation across all 1 revision of this API.