Mitglied reaktivieren

POST /fapi/v1/organizations/{org_id}/memberships/{membership_id}:reactivate · aufgerufen vom Anmelde-Host der Umgebung

Reaktiviert eine gesperrte Mitgliedschaft; das Mitglied kann die Organisation mit den zuvor gehaltenen Rollen wieder auswählen. Die Reaktivierung eines aktiven Mitglieds liefert die Mitgliedschaft unverändert zurück. Das Konto des Benutzers muss selbst aktiv sein.

Erforderlich ist entweder das Cookie __Host-idp_session des angemeldeten Benutzers mit einem exakten Origin-Header oder das Front-API-Zugriffstoken einer Erstanbieter-Anwendung (Authorization: DPoP <token> mit einem DPoP-Nachweis; siehe Front-API-Zugriffstoken). Der Benutzer muss aktives Mitglied der Organisation sein und sowohl die Berechtigung idp_members:update_roles als auch idp_members:remove besitzen. Ein Benutzer, der kein Mitglied ist, erhält 404 not_found; ein Mitglied ohne beide Berechtigungen erhält 403 insufficient_permissions. Die eigene Mitgliedschaft können Sie hier nicht ändern (403 insufficient_permissions), und nur ein Mitglied mit der Admin-Rolle kann ein Mitglied mit einer privilegierten Rolle ändern (403 role_not_assignable).

Mit @keenauth/js: await keenauth.organizations.reactivateMember(orgId, membershipId, { expectedVersion: 4 }).

Anfrage

Header:

Header Erforderlich Beschreibung
Idp-Client ja SDK-Kennung.
Origin ja, mit dem Cookie https://<sign-in host>.
If-Match nein Eine Version, "<version>", aus der Mitgliederliste. Eine Version, die nicht übereinstimmt, oder mehr als eine Version liefert 412 precondition_failed.

org_id: die Kennung der Organisation (org_…). membership_id: die Kennung der Mitgliedschaft (mem_…).

Kein Body.

Antwort

200 OK mit der Mitgliedschaft (dieselben Felder wie ein Eintrag der Mitgliederliste) und ETag: "<version>".

Fehler

Status Code Wann
400 malformed_request If-Match ist fehlerhaft.
401 unauthenticated Kein gültiges Sitzungs-Cookie oder Token.
403 insufficient_permissions Dem Benutzer fehlt idp_members:update_roles oder idp_members:remove, oder die Mitgliedschaft ist die eigene des Benutzers.
403 role_not_assignable Das Mitglied hat eine privilegierte Rolle und der Benutzer hat nicht die Admin-Rolle.
403 origin_not_allowed Der Origin-Header stimmt nicht überein.
403 user_not_active Das Konto des Benutzers ist gesperrt oder steht zur Löschung an.
404 not_found Keine solche Organisation oder Mitgliedschaft für diesen Benutzer; eine unbekannte, fehlerhafte oder fremde Kennung führt zur selben Antwort.
409 organization_disabled Die Organisation ist deaktiviert oder steht zur Löschung an (organization_pending_deletion).
412 precondition_failed If-Match nennt nicht die aktuelle Version der Mitgliedschaft.
422 validation_failed Die Mitgliedschaft wurde entfernt.
503 service_unavailable Vorübergehend nicht verfügbar; nach Retry-After erneut versuchen.

Beispiel

curl -X POST "https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a/memberships/mem_01jbz6x8kq3m2n4p5r6s7t8v9b:reactivate" \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -H 'If-Match: "3"' \
  -b cookies.txt

{
  "id": "mem_01jbz6x8kq3m2n4p5r6s7t8v9b",
  "user_id": "usr_01jbz6x8kq3m2n4p5r6s7t8v9c",
  "status": "active",
  "roles": [{ "role_id": "rol_01jbz6x8kq3m2n4p5r6s7t8v9w", "source": "admin_api" }],
  "created_at": "2026-11-03T09:00:00Z",
  "activated_at": "2026-11-03T09:00:00Z",
  "expires_at": null,
  "updated_at": "2026-11-03T11:00:00Z",
  "version": 4
}

Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Organisationsmitgliedschaften und Einladungen. Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).