Establecer la fecha de fin de una membresía
PATCH /fapi/v1/organizations/{org_id}/memberships/{membership_id} · llamado desde el host de inicio de sesión del entorno
Establece o elimina la fecha en la que termina una membresía (expires_at), para una pantalla de perfil de organización. Cuando llega la fecha, la membresía se elimina y se revocan las sesiones y los tokens del miembro en el contexto de esta organización. Se publica un evento membership_expiry_warned siete días antes. Los roles se cambian mediante Establecer los roles de un miembro; este endpoint solo cambia la fecha de fin.
Requiere la cookie __Host-idp_session del usuario autenticado con un Origin exacto, o un token de acceso de la API frontal de una aplicación propia (Authorization: DPoP <token> con una prueba DPoP; véase Token de acceso de la API frontal). El usuario debe ser miembro activo de la organización con ambos permisos, idp_members:update_roles e idp_members:remove. Un usuario que no es miembro recibe 404 not_found; un miembro sin ambos permisos recibe 403 insufficient_permissions. No puede cambiar aquí su propia membresía (403 insufficient_permissions), y solo un miembro que tenga el rol de administrador puede cambiar a un miembro que tenga un rol privilegiado (403 role_not_assignable).
Con @keenauth/js: await keenauth.organizations.setMemberExpiry(orgId, membershipId, "2027-03-31T00:00:00Z", { expectedVersion: 3 }); pase null para eliminar la fecha.
Solicitud
Encabezados:
| Encabezado | Obligatorio | Descripción |
|---|---|---|
Idp-Client |
sí | Identificador del SDK. |
Origin |
sí, con la cookie | https://<host de inicio de sesión>. |
If-Match |
no | Una versión, "<versión>", de la lista de miembros. Una versión que no coincide, o más de una versión, devuelve 412 precondition_failed. |
org_id: el identificador de la organización (org_…). membership_id: el identificador de la membresía (mem_…).
Cuerpo: {"expires_at": "<hora RFC 3339>"} o {"expires_at": null} para eliminar la fecha. expires_at es obligatorio. La hora debe estar en el futuro y ser como máximo 365 días posterior a la creación de la membresía.
Respuesta
200 OK con la membresía (los mismos campos que un elemento de la lista de miembros) y ETag: "<versión>".
Errores
| Estado | Código | Cuándo |
|---|---|---|
| 400 | unknown_field |
El cuerpo contiene un campo distinto de expires_at. |
| 400 | malformed_request |
If-Match está mal formado. |
| 401 | unauthenticated |
No hay una cookie de sesión o un token válidos. |
| 403 | insufficient_permissions |
El usuario no tiene idp_members:update_roles o idp_members:remove, o la membresía es la propia del usuario. |
| 403 | role_not_assignable |
El miembro tiene un rol privilegiado y el usuario no tiene el rol de administrador. |
| 403 | origin_not_allowed |
El Origin no coincide. |
| 404 | not_found |
No existe la organización o la membresía para este usuario; un identificador desconocido, mal formado o ajeno recibe la misma respuesta. |
| 409 | organization_disabled |
La organización está deshabilitada o pendiente de eliminación (organization_pending_deletion). |
| 412 | precondition_failed |
If-Match no indica la versión actual de la membresía. |
| 422 | validation_failed |
expires_at falta, no es una hora RFC 3339, está en el pasado o es más de 365 días posterior a la creación de la membresía. |
| 503 | service_unavailable |
No disponible temporalmente; reintente después de Retry-After. |
Ejemplo
curl -X PATCH "https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a/memberships/mem_01jbz6x8kq3m2n4p5r6s7t8v9b" \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H 'If-Match: "3"' \
-H "Content-Type: application/json" \
-b cookies.txt \
-d '{"expires_at": "2027-03-31T00:00:00Z"}'
{
"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",
"updated_at": "2026-11-03T11:00:00Z",
"version": 4
}
Datos personales
Este endpoint contiene datos personales: membresías de organizaciones e invitaciones. Datos personales en las API de KeenAuth describe qué se almacena, cuánto tiempo se conserva y cómo se elimina. No envíe categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.