ZitadelDocs

Create team

POST
/teams

Authorization

headerAuthorizationBearer <token>

Scope: team.write

Query Parameters

project_id*string

The unique identifier of the project

Match^[a-zA-Z0-9_-]+$

Request Body

application/json
  1. body
name*string

The name of the team. Must be unique within the project.

Length1 <= length <= 200

Response Body

The team was created successfully

application/json
  1. response

Details of a team.

id*string

The unique identifier of the team.

name*string

The name of the team.

status*team-status

The lifecycle state of a team.

active: The team is available for use. deactivated: The team is no longer active but is retained for historical and audit purposes.

Value in"active""deactivated"
created_at*string

The time when the team was created.

Formatdate-time
updated_at*string

The time when the team was last updated.

Formatdate-time
curl -X POST 'https://example.com/teams?project_id=string' \  -H 'Content-Type: application/json' \  -d '{  "name": "string"}'
{  "id": "string",  "name": "string",  "status": "active",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z"}