Skip to main content
POST
Validate Credential
Every request requires ?beta=true.

Authorizations

X-Api-Key
string
header
default:sk-ant-local-default
required

OMA workspace API key.

Headers

anthropic-version
string
anthropic-beta
string

Path Parameters

vault_id
string
required

Path parameter vault_id

credential_id
string
required

Path parameter credential_id

Query Parameters

beta
enum<boolean>
required

Selects the beta API contract for this endpoint. Must be true.

Available options:
true

Response

Successful response (OK)

Result of live-probing a credential against its configured MCP server.

type
enum<string>
required
Available options:
vault_credential_validation
Example:

"vault_credential_validation"

credential_id
string
required

Unique identifier of the credential that was validated.

Example:

"vcrd_011CZkZEMt8gZan2iYOQfSkw"

vault_id
string
required

Identifier of the vault containing the credential.

Example:

"vlt_011CZkZDLs7fYzm1hXNPeRjv"

status
enum<string>
required

Overall verdict of the validation probe.

Available options:
valid,
invalid,
unknown
Example:

"valid"

validated_at
string<date-time>
required

When the validation probe was performed.

Example:

"2026-03-15T10:00:00Z"

has_refresh_token
boolean
required

Whether the credential has a refresh token configured.

Example:

true

mcp_probe
object | null
required

Details of the failing MCP probe step. Null when the probe succeeded.

Example:

null

refresh
object | null
required

Details of the refresh-token exchange attempted on a 401. Null when no refresh was attempted.

Example:

null