ZitadelDocs

Get team

Returns a Team by its id.

GET
/teams/{team_id}

Returns a Team by its id.

Authorization

headerAuthorizationBearer <token>

Scope: team.read

Path Parameters

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

Response Body

The team.

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 GET 'https://example.com/teams/string'
{  "id": "string",  "name": "string",  "status": "active",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z"}