Üyeyi yeniden etkinleştir
POST /fapi/v1/organizations/{org_id}/memberships/{membership_id}:reactivate · ortamın oturum açma ana bilgisayarından çağrılır
Askıya alınmış bir üyeliği yeniden etkinleştirir; üye, sahip olduğu rollerle kuruluşu yeniden seçebilir. Etkin bir üyeyi yeniden etkinleştirmek, üyeliği değiştirmeden yanıtlar. Kullanıcının hesabı kendisi de etkin olmalıdır.
Kimliği doğrulanmış kullanıcının, tam bir Origin ile birlikte __Host-idp_session çerezi gerekir; ya da birinci taraf bir uygulamanın ön uç API erişim belirteci (Authorization: DPoP <token> ve bir DPoP kanıtı ile; bkz. Ön uç API erişim belirteci). Kullanıcının kuruluşun etkin bir üyesi olması ve hem idp_members:update_roles hem de idp_members:remove izinlerine sahip olması gerekir. Üye olmayan bir kullanıcı 404 not_found alır; iki izne de sahip olmayan bir üye 403 insufficient_permissions alır. Kendi üyeliğinizi burada değiştiremezsiniz (403 insufficient_permissions); ayrıca ayrıcalıklı bir rol taşıyan bir üyeyi yalnızca yönetici rolüne sahip bir üye değiştirebilir (403 role_not_assignable).
@keenauth/js ile: await keenauth.organizations.reactivateMember(orgId, membershipId, { expectedVersion: 4 }).
İstek
Üstbilgiler:
| Üstbilgi | Zorunlu | Açıklama |
|---|---|---|
Idp-Client |
evet | SDK tanımlayıcısı. |
Origin |
evet, çerezle birlikte | https://<sign-in host>. |
If-Match |
hayır | Üye listesinden alınmış tek bir sürüm, "<version>". Eşleşmeyen bir sürüm veya birden fazla sürüm 412 precondition_failed döndürür. |
org_id: kuruluş tanımlayıcısı (org_…). membership_id: üyelik tanımlayıcısı (mem_…).
Gövde yok.
Yanıt
200 OK ile üyelik (bu alanlar üye listesindeki bir öğeyle aynıdır) ve ETag: "<version>".
Hatalar
| Durum | Kod | Ne zaman |
|---|---|---|
| 400 | malformed_request |
If-Match hatalı biçimlendirilmişse. |
| 401 | unauthenticated |
Geçerli bir oturum çerezi veya belirteci yoksa. |
| 403 | insufficient_permissions |
Kullanıcıda idp_members:update_roles veya idp_members:remove yoksa ya da üyelik kullanıcının kendisine aitse. |
| 403 | role_not_assignable |
Üye ayrıcalıklı bir rol taşıyorsa ve kullanıcı yönetici rolüne sahip değilse. |
| 403 | origin_not_allowed |
Origin eşleşmiyorsa. |
| 403 | user_not_active |
Kullanıcının hesabı engellenmişse veya silinmek üzere bekliyorsa. |
| 404 | not_found |
Bu kullanıcı için böyle bir kuruluş veya üyelik yoksa; bilinmeyen, hatalı biçimlendirilmiş veya başkasına ait tanımlayıcı aynı yanıtı verir. |
| 409 | organization_disabled |
Kuruluş devre dışıysa veya silinmek üzere bekliyorsa (organization_pending_deletion). |
| 412 | precondition_failed |
If-Match, üyeliğin geçerli sürümünü belirtmiyorsa. |
| 422 | validation_failed |
Üyelik kaldırılmışsa. |
| 503 | service_unavailable |
Geçici olarak kullanılamıyor; Retry-After değerinden sonra yeniden deneyin. |
Örnek
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
}
Kişisel veriler
Bu uç nokta kişisel veri içerir: kuruluş üyelikleri ve davetler. KeenAuth API'lerinde kişisel veriler sayfası neyin saklandığını, ne kadar süre tutulduğunu ve nasıl silindiğini açıklar. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.