Silinmiş bir bağlantıyı geri yükle

POST /v1/connections/{connection_id}:restore · izin connections:write

Silinmiş bir bağlantıyı geri getirir. Silinmiş bir bağlantı 30 gün boyunca geri yüklenebilir; bu sürede listelenmez, okunamaz (404) ve oturum açmak için kullanılamaz. 30 gün sonra kalıcı olarak silinir.

Geri yüklenen bağlantı önceki ayarlarıyla ve status = inactive durumunda geri gelir. Asla otomatik etkinleştirilmez: hazır olduğunuzda :activate çağrısı yapın (kurumsal bağlantı için test gereksinimi ve plan kotası orada kontrol edilir). Bağlantı silindiğinde uygulama bağlantı listeleri ve bağlantının rol eşlemeleri kaldırılır ve geri getirilmez.

İstek gövdesi isteğe bağlıdır ve alan içermez. İşlem idempotenttir: bağlantı silinmemişse hiçbir şey yazılmaz ve mevcut bağlantı döndürülür.

İstek

Alan Tür Zorunlu Açıklama
connection_id string evet Bağlantı tanımlayıcısı (conn_…).
Idempotency-Key header hayır Yeniden denenen isteği güvenli hale getiren isteğe bağlı anahtar (16-64 karakter).

Gövde isteğe bağlıdır; varsa {} olmalıdır.

Yanıt

200 OK ile bağlantı ve ETag değeri döndürülür.

{
  "id": "conn_0k3v8m1q2x9dz4h7s5t6w0y1ab",
  "key": "acme-saml",
  "type": "enterprise",
  "strategy": "saml",
  "name": "Acme SAML",
  "display_name": null,
  "status": "inactive",
  "org_id": "org_0k3v8m1q2x9dz4h7s5t6w0y1ac",
  "allowed_email_domains": ["acme.example"],
  "allow_external_domains": false,
  "jit_mode": "create",
  "email_trust": false,
  "default_role_ids": [],
  "trust_idp_mfa": false,
  "allow_idp_initiated": false,
  "idp_initiated_default_application_id": null,
  "idp_initiated_allowed_application_ids": [],
  "settings": {},
  "created_at": "2026-10-05T09:30:00.123456Z",
  "updated_at": "2026-10-26T17:00:00.123456Z"
}

Hatalar

HTTP kod Ne zaman
400 unknown_field Gövde bir alan içeriyor.
404 not_found Bağlantı yok, başka bir ortama ait veya 30 günden daha önce silinmiş.
409 conflict Başka bir bağlantı artık aynı key veya name değerini kullanıyor (ya da tek passkey veya sosyal sağlayıcı yuvasını) ya da bağlantının ait olduğu kuruluş silinmiş.
403 quota_exceeded Ortam zaten izin verilen en fazla bağlantı sayısına ulaşmış.
401 unauthenticated Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Kimlik bilgisi gerekli izne sahip değil.
429 rate_limited Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin.

Örnek

curl -X POST https://api.eu.keenauth.com/v1/connections/conn_0k3v8m1q2x9dz4h7s5t6w0y1ab:restore \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth connections restore conn_0k3v8m1q2x9dz4h7s5t6w0y1ab