Teams

Get teams.

get

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Query parameters

start-indexinteger · int32Optional

an integer specifying the starting point (beginning with 0) when paging through a list of entities

Default: 0

max-resultsinteger · int32 · max: 100Optional

the maximum number of results when paging through a list of entities.

Default: 50

membersnumberOptional

optional, filter teams for specific members (currently only a single occurrence of this param is allowed)

Responses

200

The teams

application/json

get

/teams

HTTPcURLJavaScriptPython

GET /api/teams HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

The teams

[
  {
    "id": 1,
    "name": "text",
    "visibility": "PUBLIC",
    "members": [
      {
        "user": {
          "id": 1,
          "firstName": "text",
          "lastName": "text",
          "email": "text",
          "timezone": "Europe/Berlin",
          "position": "text",
          "department": "text",
          "avatarUrl": "text",
          "language": "de",
          "region": "DE",
          "role": "STAKEHOLDER",
          "shiftColor": "text",
          "mutedUntil": "2025-12-27T21:26:16.377Z",
          "createdAt": "2025-12-27T21:26:16.377Z",
          "updatedAt": "2025-12-27T21:26:16.377Z"
        },
        "role": "STAKEHOLDER"
      }
    ],
    "createdAt": "2025-12-27T21:26:16.377Z",
    "updatedAt": "2025-12-27T21:26:16.377Z"
  }
]

Create a new team.

post

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Body

application/json

idinteger · int64Optional

namestringOptional

visibilitystring · enumOptionalPossible values:

createdAtstring · date-timeOptional

Date in ISO-8601

updatedAtstring · date-timeOptional

Date in ISO-8601

Responses

200

The newly created team

application/json

post

/teams

HTTPcURLJavaScriptPython

POST /api/teams HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 479

{
  "id": 1,
  "name": "text",
  "visibility": "PUBLIC",
  "members": [
    {
      "user": {
        "id": 1,
        "firstName": "text",
        "lastName": "text",
        "email": "text",
        "timezone": "Europe/Berlin",
        "position": "text",
        "department": "text",
        "language": "de",
        "region": "DE",
        "role": "STAKEHOLDER",
        "shiftColor": "text",
        "mutedUntil": "2025-12-27T21:26:16.377Z",
        "createdAt": "2025-12-27T21:26:16.377Z",
        "updatedAt": "2025-12-27T21:26:16.377Z"
      },
      "role": "STAKEHOLDER"
    }
  ],
  "createdAt": "2025-12-27T21:26:16.377Z",
  "updatedAt": "2025-12-27T21:26:16.377Z"
}

200

The newly created team

{
  "id": 1,
  "name": "text",
  "visibility": "PUBLIC",
  "members": [
    {
      "user": {
        "id": 1,
        "firstName": "text",
        "lastName": "text",
        "email": "text",
        "timezone": "Europe/Berlin",
        "position": "text",
        "department": "text",
        "avatarUrl": "text",
        "language": "de",
        "region": "DE",
        "role": "STAKEHOLDER",
        "shiftColor": "text",
        "mutedUntil": "2025-12-27T21:26:16.377Z",
        "createdAt": "2025-12-27T21:26:16.377Z",
        "updatedAt": "2025-12-27T21:26:16.377Z"
      },
      "role": "STAKEHOLDER"
    }
  ],
  "createdAt": "2025-12-27T21:26:16.377Z",
  "updatedAt": "2025-12-27T21:26:16.377Z"
}

Get a specific team.

get

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idnumberRequired

entity ID

Responses

200

The requested team

application/json

get

/teams/{id}

HTTPcURLJavaScriptPython

GET /api/teams/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

The requested team

{
  "id": 1,
  "name": "text",
  "visibility": "PUBLIC",
  "members": [
    {
      "user": {
        "id": 1,
        "firstName": "text",
        "lastName": "text",
        "email": "text",
        "timezone": "Europe/Berlin",
        "position": "text",
        "department": "text",
        "avatarUrl": "text",
        "language": "de",
        "region": "DE",
        "role": "STAKEHOLDER",
        "shiftColor": "text",
        "mutedUntil": "2025-12-27T21:26:16.377Z",
        "createdAt": "2025-12-27T21:26:16.377Z",
        "updatedAt": "2025-12-27T21:26:16.377Z"
      },
      "role": "STAKEHOLDER"
    }
  ],
  "createdAt": "2025-12-27T21:26:16.377Z",
  "updatedAt": "2025-12-27T21:26:16.377Z"
}

Update the specific team

put

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idnumberRequired

entity ID

Body

application/json

idinteger · int64Optional

namestringOptional

visibilitystring · enumOptionalPossible values:

createdAtstring · date-timeOptional

Date in ISO-8601

updatedAtstring · date-timeOptional

Date in ISO-8601

Responses

200

The updated team

application/json

put

/teams/{id}

HTTPcURLJavaScriptPython

PUT /api/teams/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 479

{
  "id": 1,
  "name": "text",
  "visibility": "PUBLIC",
  "members": [
    {
      "user": {
        "id": 1,
        "firstName": "text",
        "lastName": "text",
        "email": "text",
        "timezone": "Europe/Berlin",
        "position": "text",
        "department": "text",
        "language": "de",
        "region": "DE",
        "role": "STAKEHOLDER",
        "shiftColor": "text",
        "mutedUntil": "2025-12-27T21:26:16.377Z",
        "createdAt": "2025-12-27T21:26:16.377Z",
        "updatedAt": "2025-12-27T21:26:16.377Z"
      },
      "role": "STAKEHOLDER"
    }
  ],
  "createdAt": "2025-12-27T21:26:16.377Z",
  "updatedAt": "2025-12-27T21:26:16.377Z"
}

200

The updated team

{
  "id": 1,
  "name": "text",
  "visibility": "PUBLIC",
  "members": [
    {
      "user": {
        "id": 1,
        "firstName": "text",
        "lastName": "text",
        "email": "text",
        "timezone": "Europe/Berlin",
        "position": "text",
        "department": "text",
        "avatarUrl": "text",
        "language": "de",
        "region": "DE",
        "role": "STAKEHOLDER",
        "shiftColor": "text",
        "mutedUntil": "2025-12-27T21:26:16.377Z",
        "createdAt": "2025-12-27T21:26:16.377Z",
        "updatedAt": "2025-12-27T21:26:16.377Z"
      },
      "role": "STAKEHOLDER"
    }
  ],
  "createdAt": "2025-12-27T21:26:16.377Z",
  "updatedAt": "2025-12-27T21:26:16.377Z"
}

Remove a specific team.

delete

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idnumberRequired

entity ID

Responses

204

Empty body delete response

delete

/teams/{id}

HTTPcURLJavaScriptPython

DELETE /api/teams/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

204

Empty body delete response

No content

Add a new team member to specific team

post

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idnumberRequired

entity ID

Body

application/json

rolestring · enumOptionalPossible values:

Responses

200

The added team member

application/json

post

/teams/{id}/members

HTTPcURLJavaScriptPython

POST /api/teams/{id}/members HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 344

{
  "user": {
    "id": 1,
    "firstName": "text",
    "lastName": "text",
    "email": "text",
    "timezone": "Europe/Berlin",
    "position": "text",
    "department": "text",
    "language": "de",
    "region": "DE",
    "role": "STAKEHOLDER",
    "shiftColor": "text",
    "mutedUntil": "2025-12-27T21:26:16.377Z",
    "createdAt": "2025-12-27T21:26:16.377Z",
    "updatedAt": "2025-12-27T21:26:16.377Z"
  },
  "role": "STAKEHOLDER"
}

200

The added team member

{
  "user": {
    "id": 1,
    "firstName": "text",
    "lastName": "text",
    "email": "text",
    "timezone": "Europe/Berlin",
    "position": "text",
    "department": "text",
    "avatarUrl": "text",
    "language": "de",
    "region": "DE",
    "role": "STAKEHOLDER",
    "shiftColor": "text",
    "mutedUntil": "2025-12-27T21:26:16.377Z",
    "createdAt": "2025-12-27T21:26:16.377Z",
    "updatedAt": "2025-12-27T21:26:16.377Z"
  },
  "role": "STAKEHOLDER"
}

Remove a specific member of a specific team.

delete

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idnumberRequired

entity ID

Responses

204

Empty body delete response

delete

/teams/{id}/members/{id}

HTTPcURLJavaScriptPython

DELETE /api/teams/{id}/members/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

204

Empty body delete response

No content