Zum Inhalt springen
API-Referenz

Team

5 Endpunkte

Mitglieder

get/v1/members

Mitglieder und offene Einladungen.

Antwort 200Object

Mögliche Fehler

  • 400 Anfrage ungültig
  • 401 Nicht angemeldet
  • 403 Berechtigung fehlt
  • 404 Nicht gefunden
  • 409 Zustand passt nicht
  • 429 Zu viele Anfragen
Beispiel
curl -X GET https://api.ladehase.com/v1/members \n  -H "Authorization: Bearer lh_test_…"
Antwort 200
{}

Person einladen

post/v1/invitations

Rollen: owner, admin, member.

Parameter

NameOrtTyp
idempotency-keyoptionalWiederholbare Anfragen ohne doppelte Wirkung (24 Stunden)Kopfzeilestring

Anfrage

NameTypBeschreibung
emailPflichtstring (email)
roleoptional"owner" | "admin" | "member"

Antwort 201Object

Mögliche Fehler

  • 400 Anfrage ungültig
  • 401 Nicht angemeldet
  • 403 Berechtigung fehlt
  • 404 Nicht gefunden
  • 409 Zustand passt nicht
  • 429 Zu viele Anfragen
Beispiel
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"}'
Antwort 201
{}

Einladung zurückziehen

delete/v1/invitations/{id}

Der Link wird ungültig.

Parameter

NameOrtTyp
idPflichtPfadstring

Antwort 200Deleted

NameTypBeschreibung
idPflichtstring
objectPflichtstring
deletedPflichttrue

Mögliche Fehler

  • 400 Anfrage ungültig
  • 401 Nicht angemeldet
  • 403 Berechtigung fehlt
  • 404 Nicht gefunden
  • 409 Zustand passt nicht
  • 429 Zu viele Anfragen
Beispiel
curl -X DELETE https://api.ladehase.com/v1/invitations/{id} \n  -H "Authorization: Bearer lh_test_…"
Antwort 200
{
  "id": "string",
  "object": "string",
  "deleted": true
}

Rolle ändern

patch/v1/members/{id}

Mindestens eine Inhaberin oder ein Inhaber bleibt.

Parameter

NameOrtTyp
idPflichtPfadstring

Anfrage

NameTypBeschreibung
rolePflicht"owner" | "admin" | "member"

Antwort 200Object

Mögliche Fehler

  • 400 Anfrage ungültig
  • 401 Nicht angemeldet
  • 403 Berechtigung fehlt
  • 404 Nicht gefunden
  • 409 Zustand passt nicht
  • 429 Zu viele Anfragen
Beispiel
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"}'
Antwort 200
{}

Mitglied entfernen

delete/v1/members/{id}

Entfernt die Person aus der Organisation.

Parameter

NameOrtTyp
idPflichtPfadstring

Antwort 200Deleted

NameTypBeschreibung
idPflichtstring
objectPflichtstring
deletedPflichttrue

Mögliche Fehler

  • 400 Anfrage ungültig
  • 401 Nicht angemeldet
  • 403 Berechtigung fehlt
  • 404 Nicht gefunden
  • 409 Zustand passt nicht
  • 429 Zu viele Anfragen
Beispiel
curl -X DELETE https://api.ladehase.com/v1/members/{id} \n  -H "Authorization: Bearer lh_test_…"
Antwort 200
{
  "id": "string",
  "object": "string",
  "deleted": true
}