Réactiver une adhésion

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

Réactive une adhésion suspendue ; l'organisation et l'utilisateur doivent être actifs. Réactiver une adhésion déjà active n'écrit rien. L'écriture est journalisée sous organization_membership.updated avec change=reactivated.

Requête

Champ Type Obligatoire Description
org_id path oui Identifiant de l'organisation (org_…).
membership_id path oui Identifiant de l'adhésion (mem_…).
If-Match header non ETag actuel ; s'il est fourni, il doit correspondre (412) et l'écriture est liée à cette version.

Aucun corps de requête.

Réponse

200 OK avec l'adhésion mise à jour et son 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
}

Erreurs

HTTP code Quand
404 not_found L'adhésion n'existe pas dans cette organisation.
409 organization_disabled L'organisation est désactivée.
409 user_not_active L'utilisateur n'est pas actif.
412 precondition_failed If-Match ne correspond pas à la version actuelle.
422 validation_failed L'adhésion n'est pas suspendue (/status invalid_state).
401 unauthenticated Le justificatif est absent, invalide ou révoqué.
403 insufficient_permissions Le justificatif ne dispose pas de l'autorisation requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après la période indiquée par Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après la période indiquée par Retry-After.

Exemple

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

Données personnelles

Cet endpoint traite des données personnelles : adhésions aux organisations et invitations. Données personnelles dans les API KeenAuth décrit les données conservées, leur durée de conservation et leur suppression. Ne transmettez aucune catégorie particulière de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.