## Validate External Key ### Path Parameters ### Returns ### Example #### Response
The whole hunk
58 lines, first recorded
/
lines
The first capture of this source. The page was already there, and this is what it said.
---
title: Validate External Key
url: https://platform.claude.com/docs/en/api/admin/external_keys/validate
---
## Validate External Key
**post** `/v1/organizations/external_keys/{external_key_id}/validate`
Validate an external key config against the customer's KMS.
Anthropic performs an encrypt/decrypt roundtrip against the configured
KMS key and waits up to 30 seconds for the result. The response status is
`success` if the roundtrip succeeded, or `failure` with an error
message if it failed or timed out.
### Path Parameters
- `external_key_id: string`
ID of the External Key.
### Returns
- `error: string or null`
Error message when status is `failure`. Null otherwise.
- `status: "failure" or "success"`
`success` — encrypt/decrypt roundtrip succeeded. `failure` — the roundtrip failed or timed out; see `error`.
- `"failure"`
- `"success"`
- `type: "external_key_validation"`
- `"external_key_validation"`
### Example
```http
curl https://api.anthropic.com/v1/organizations/external_keys/$EXTERNAL_KEY_ID/validate \
-X POST \
-H 'anthropic-version: 2023-06-01' \
-H "Authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"
```
#### Response
```json
{
"error": null,
"status": "success",
"type": "external_key_validation"
}
```