Eine Mitgliedschaft reaktivieren

POST /v1/organizations/{org_id}/memberships/{membership_id}:reactivate · Berechtigung organizations:write

Reaktiviert eine gesperrte Mitgliedschaft; die Organisation und der Nutzer müssen aktiv sein. Die Reaktivierung einer aktiven Mitgliedschaft schreibt nichts. Der Schreibvorgang wird als organization_membership.updated mit change=reactivated protokolliert.

Anfrage

Feld Typ Pflicht Beschreibung
org_id path ja Organisations-ID (org_…).
membership_id path ja Mitgliedschafts-ID (mem_…).
If-Match header nein Aktueller ETag; wenn angegeben, muss er übereinstimmen (412) und bindet den Schreibvorgang an diese Version.

Kein Anfragekörper.

Antwort

200 OK mit der aktualisierten Mitgliedschaft und ihrem ETag.

{
  "id": "mem_01j9xn5p9s0t4v6w8x0y2z4a6c",
  "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "user_id": "usr_01j9xh2k6p7q1r3s5t7v9w1x3y",
  "status": "active",
  "source": "admin_api",
  "reason": null,
  "roles": [
    {
      "role_id": "rol_01j9xr7s1t2w6x8y0z2a4b6c8e",
      "source": "admin_api",
      "assigned_at": "2026-10-12T09:31:00.123456Z"
    }
  ],
  "expires_at": null,
  "created_at": "2026-10-12T09:31:00.123456Z",
  "activated_at": "2026-10-12T09:31:00.123456Z",
  "suspended_at": null,
  "removed_at": null,
  "updated_at": "2026-10-12T10:00:00Z",
  "version": 3
}

Fehler

HTTP code Wann
404 not_found Die Mitgliedschaft existiert in dieser Organisation nicht.
409 organization_disabled Die Organisation ist deaktiviert.
409 user_not_active Der Nutzer ist nicht aktiv.
412 precondition_failed If-Match stimmt nicht mit der aktuellen Version überein.
422 validation_failed Die Mitgliedschaft ist nicht gesperrt (/status invalid_state).
401 unauthenticated Der Berechtigungsnachweis fehlt, ist ungültig oder widerrufen.
403 insufficient_permissions Der Berechtigungsnachweis hat nicht die erforderliche Berechtigung.
429 rate_limited Das Ratenlimit wurde überschritten; wiederholen Sie die Anfrage nach der Zeitspanne Retry-After.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach der Zeitspanne Retry-After.

Beispiel

curl -i -X POST "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/memberships/mem_01j9xn5p9s0t4v6w8x0y2z4a6c:reactivate" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

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).