Team

5 endpoint

Le descrizioni degli endpoint provengono direttamente dall'API e sono in tedesco.

Mitglieder

get/v1/members

Mitglieder und offene Einladungen.

Risposta 200Object

Errori possibili

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Esempio

curl -X GET https://api.ladehase.com/v1/members \n  -H "Authorization: Bearer lh_test_…"

Risposta 200

{}

Person einladen

post/v1/invitations

Rollen: owner, admin, member.

Parametri

Nome	Posizione	Tipo
`idempotency-key`facoltativoWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)	Intestazione	string

Richiesta

Nome	Tipo	Descrizione
`email`obbligatorio	string (email)
`role`facoltativo	"owner" \| "admin" \| "member"

Risposta 201Object

Errori possibili

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Esempio

curl -X POST https://api.ladehase.com/v1/invitations \n  -H "Authorization: Bearer lh_test_…" \n  -H "Content-Type: application/json" \n  -d '{"email":"person@example.ch","role":"member"}'

Risposta 201

{}

Einladung zurückziehen

delete/v1/invitations/{id}

Der Link wird ungültig.

Parametri

Nome	Posizione	Tipo
`id`obbligatorio	Percorso	string

Risposta 200Deleted

Nome	Tipo	Descrizione
`id`obbligatorio	string
`object`obbligatorio	string
`deleted`obbligatorio	true

Errori possibili

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Esempio

curl -X DELETE https://api.ladehase.com/v1/invitations/{id} \n  -H "Authorization: Bearer lh_test_…"

Risposta 200

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

Rolle ändern

patch/v1/members/{id}

Mindestens eine Inhaberin oder ein Inhaber bleibt.

Parametri

Nome	Posizione	Tipo
`id`obbligatorio	Percorso	string

Richiesta

Nome	Tipo	Descrizione
`role`obbligatorio	"owner" \| "admin" \| "member"

Risposta 200Object

Errori possibili

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Esempio

curl -X PATCH https://api.ladehase.com/v1/members/{id} \n  -H "Authorization: Bearer lh_test_…" \n  -H "Content-Type: application/json" \n  -d '{"role":"owner"}'

Risposta 200

{}

Mitglied entfernen

delete/v1/members/{id}

Entfernt die Person aus der Organisation.

Parametri

Nome	Posizione	Tipo
`id`obbligatorio	Percorso	string

Risposta 200Deleted

Nome	Tipo	Descrizione
`id`obbligatorio	string
`object`obbligatorio	string
`deleted`obbligatorio	true

Errori possibili

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Esempio

curl -X DELETE https://api.ladehase.com/v1/members/{id} \n  -H "Authorization: Bearer lh_test_…"

Risposta 200

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