Claude Platform Docs

Valider une clé externe

organization.external_keys.validate(external_key_id) -> ExternalKeyValidateResponse
POST/v1/organizations/external_keys/{external_key_id}/validate

Validez une configuration de clé externe auprès du KMS du client.

Anthropic effectue un aller-retour de chiffrement/déchiffrement avec la clé KMS configurée et attend le résultat jusqu'à 30 secondes. Le statut de la réponse est success si l'aller-retour a réussi, ou failure avec un message d'erreur s'il a échoué ou expiré.

Parameters
external_key_id: String⁠Path parameter

ID of the External Key.

maxLength2048
Returns
class ExternalKeyValidateResponse { type: :external_key_validation, error, status }

Result of a validation roundtrip against the customer's KMS.

HTTP 200 for both outcomes — the operation completed; status says whether the key works.

type: :external_key_validation
error: String

Error message when status is failure. Null otherwise.

status: :failure | :success

success — encrypt/decrypt roundtrip succeeded. failure — the roundtrip failed or timed out; see error.

One of the following:
:failure
:success
Valider une clé externe
require "anthropic"

anthropic = Anthropic::Client.new(api_key: "my-anthropic-api-key")

response = anthropic.organization.external_keys.validate("external_key_id")

puts(response)
Returns Examples
Response 200
{
  "error": "error",
  "status": "failure",
  "type": "external_key_validation"
}