削除された接続を復元
POST /v1/connections/{connection_id}:restore · 権限 connections:write
削除された接続を復元します。削除された接続は 30 日間復元できます。その間は一覧に表示されず、読み取りはできません（404）し、サインインに使用することもできません。30 日経過すると完全に削除されます。
復元された接続は、以前の設定と status = inactive の状態で戻ります。自動的に有効化されることはありません。準備ができたら :activate を呼び出してください（エンタープライズ接続の場合、テスト要件とプランのクォータはその時点で確認されます）。アプリケーションの接続一覧と接続のロールマッピングは、接続の削除時に削除されており、復元されません。
リクエストボディは省略可能で、フィールドはありません。この操作は冪等です。接続が削除されていない場合は何も書き込まれず、現在の接続が返されます。
リクエスト
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
connection_id |
string | はい | 接続の識別子（conn_…）。 |
Idempotency-Key |
header | いいえ | リクエストを再試行しても安全になるオプションのキー（16〜64 文字）。 |
ボディは省略可能です。指定する場合は {} である必要があります。
レスポンス
200 OK と、接続およびその ETag を返します。
{
"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"
}
エラー
| HTTP | code | 発生条件 |
|---|---|---|
| 400 | unknown_field |
ボディにフィールドが含まれています。 |
| 404 | not_found |
接続が存在しないか、別の環境に属しているか、30 日より前に削除されています。 |
| 409 | conflict |
別の接続が同じ key または name を使用しているか（または単一のパスキーまたはソーシャルプロバイダーの枠を使用しているか）、所有する組織が削除されています。 |
| 403 | quota_exceeded |
環境の接続数が上限に達しています。 |
| 401 | unauthenticated |
認証情報が指定されていないか、無効か、取り消されています。 |
| 403 | insufficient_permissions |
認証情報に必要な権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After の期間を待ってから再試行してください。 |
| 503 | service_unavailable |
依存先サービスが一時的に利用できません。Retry-After の期間を待ってから再試行してください。 |
例
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