# API-Referenz: Team

## Mitglieder

`GET /v1/members`

Mitglieder und offene Einladungen.

Antwort 200:

```json
{}
```

## Person einladen

`POST /v1/invitations`

Rollen: owner, admin, member.

Parameter:

- `idempotency-key` (header, string): Wiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)

Anfrage:

```json
{
  "email": "person@example.ch",
  "role": "member"
}
```

Antwort 201:

```json
{}
```

## Einladung zurückziehen

`DELETE /v1/invitations/{id}`

Der Link wird ungültig.

Parameter:

- `id` (path, string, Pflicht)

Antwort 200:

```json
{
  "id": "string",
  "object": "string",
  "deleted": true
}
```

## Rolle ändern

`PATCH /v1/members/{id}`

Mindestens eine Inhaberin oder ein Inhaber bleibt.

Parameter:

- `id` (path, string, Pflicht)

Anfrage:

```json
{
  "role": "owner"
}
```

Antwort 200:

```json
{}
```

## Mitglied entfernen

`DELETE /v1/members/{id}`

Entfernt die Person aus der Organisation.

Parameter:

- `id` (path, string, Pflicht)

Antwort 200:

```json
{
  "id": "string",
  "object": "string",
  "deleted": true
}
```