List my teams

GET

/api/v1/me/teams

curl --request GET \
  --url https://api.deploybase.eu/api/v1/api/v1/me/teams \
  --header 'Authorization: <Authorization>'

Returns every team the signed-in user is a member of, most recently active first, each with the caller’s role in it and flags for which one is their home team and which one the current request is acting on. Teams that are being purged or have been purged are omitted; a suspended team is included with status “suspended” so the switcher can explain why it is unusable. Requires a signed-in user: API keys authenticate a team, not a person.

Authorizations

• BearerAuth

Responses

200

OK

Media type application/json

object

data

meta

object

request_id

string

timestamp

string

trace_id

string

data

Array<object>

object

display_label

DisplayLabel is what to show a human. Never empty, even for teams whose name is still a raw Zitadel org UUID — models.Team.DisplayLabel owns that fallback.

string

id

string

is_active

IsActive marks the team the current request is acting on.

boolean

is_home

IsHome marks the team the caller’s own Zitadel org maps to. Exactly one entry has it.

boolean

last_active_at

string

name

string

role

string

slug

string

status

Status is the team’s lifecycle state, with “suspended” taking precedence over the deletion state machine: a suspended team is usually active, and “active” is exactly the wrong thing to tell someone whose team is closed.

string

Example ^generated

{
  "data": [
    {
      "display_label": "example",
      "id": "example",
      "is_active": true,
      "is_home": true,
      "last_active_at": "example",
      "name": "example",
      "role": "example",
      "slug": "example",
      "status": "example"
    }
  ],
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

401

Unauthorized

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

403

Forbidden

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

500

Internal Server Error

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}

503

Service Unavailable

Media type application/json

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Example ^generated

{
  "code": "example",
  "details": "example",
  "error": "example",
  "meta": {
    "request_id": "example",
    "timestamp": "example",
    "trace_id": "example"
  }
}