テキストの上書きを削除
DELETE /v1/branding/texts/{screen}/{locale} · 権限 branding:write
1 つの画面とロケールのテキスト上書きを削除します。key を指定するとそのキーのみ、指定しない場合はスコープ内のその画面とロケールのすべての上書きが削除されます。削除したキーは公開後にカタログテキストに戻ります。上書きのないキーの削除はエラーになりません。
リクエスト
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
screen |
パス | はい | ホスト型ページの画面 (例: login、authorize)。 |
locale |
パス | はい | サポートされるロケール (例: en、tr)。 |
application_id |
クエリ | いいえ | アプリケーションスコープ (app_…)。これと org_id がない場合は環境スコープ。 |
org_id |
クエリ | いいえ | 組織スコープ (org_…)。application_id と同時に指定できません。 |
key |
クエリ、繰り返し | いいえ | 削除するキー (最大 500)。 |
レスポンス
204 No Content。
エラー
| HTTP | コード | 概要 |
|---|---|---|
| 404 | not_found |
application_id または org_id の形式が不正か、この環境にアプリケーションが存在しません。 |
| 422 | validation_failed |
key の値が 500 を超えています (too_many)。 application_id と org_id が同時に指定された (mutually_exclusive)、またはどちらかが繰り返された (repeated)。 |
| 401 | unauthenticated |
認証情報がない、無効、または失効しています。 |
| 403 | insufficient_permissions |
認証情報に必要な権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After の期間後に再試行してください。 |
| 503 | service_unavailable |
依存サービスが一時的に利用できません。Retry-After の期間後に再試行してください。 |
例
curl -X DELETE "https://api.eu.keenauth.com/v1/branding/texts/login/tr?key=title&key=subtitle" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"