Organization

Create a team

Add a team under an existing node of the organization tree.

Required scope organisation:add

post/teams

Authorizations

Authorizationstringrequired

Authorization header carrying a workspace API key, as “Bearer kbn_live_…”. The X-Api-Key header is accepted equivalently.

Bodyapplication/json

namestringrequired

Name of the team.

parentOrganizationIdstring<uuid>required

Node to create the team under.

iconstring

Icon of the team.

Response201 · application/json

The team was created.

idstring<uuid>required

Identifier of the team.

namestringrequired

Name of the team.

typestringrequired

Kind of node: an organization or a business unit.

descriptionstring | null

Free-text description of the team.

iconstring | null

Icon of the team.

parentOrganizationIdstring<uuid> | null

Parent node in the organization tree.

createdAtstring<date-time>

Timestamp the team was created.

updatedAtstring<date-time>

Timestamp of the last change.