Validate Credential

$ ant beta:vaults:credentials mcp-oauth-validate

POST/v1/vaults/{vault_id}/credentials/{credential_id}/mcp_oauth_validate

Validate Credential

Parameters

--vault-id: string

Path param: Path parameter vault_id

--credential-id: string

Path param: Path parameter credential_id

--beta: optional array of AnthropicBeta

Header param: Optional header to specify the beta version(s) you want to use.

Returns

beta_managed_agents_credential_validation: object{ credential_id, has_refresh_token, mcp_probe, 5 more }

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

credential_id: string

Unique identifier of the credential that was validated.

has_refresh_token: boolean

Whether the credential has a refresh token configured.

mcp_probe: object{ http_response, method }

The failing step of an MCP validation probe.

http_response: object{ body, body_truncated, content_type, status_code }

An HTTP response captured during a credential validation probe.

body: string

Response body. May be truncated and has sensitive values scrubbed.

body_truncated: boolean

Whether body was truncated.

content_type: string

Value of the Content-Type response header.

status_code: number

HTTP status code.

formatint32

method: string

The MCP method that failed (for example initialize or tools/list).

refresh: object{ http_response, status }

Outcome of a refresh-token exchange attempted during credential validation.

http_response: object{ body, body_truncated, content_type, status_code }

An HTTP response captured during a credential validation probe.

body: string

Response body. May be truncated and has sensitive values scrubbed.

body_truncated: boolean

Whether body was truncated.

content_type: string

Value of the Content-Type response header.

status_code: number

HTTP status code.

formatint32

status: "succeeded" or "failed" or "connect_error" or "no_refresh_token"

Outcome of a refresh-token exchange attempted during credential validation.

One of the following:

"succeeded"

"failed"

"connect_error"

"no_refresh_token"

status: "valid" or "invalid" or "unknown"

Overall verdict of a credential validation probe.

One of the following:

"valid"

"invalid"

"unknown"

type: "vault_credential_validation"

validated_at: string

A timestamp in RFC 3339 format

formatdate-time

vault_id: string

Identifier of the vault containing the credential.

Validate Credential

ant beta:vaults:credentials mcp-oauth-validate \
  --api-key my-anthropic-api-key \
  --vault-id vlt_011CZkZDLs7fYzm1hXNPeRjv \
  --credential-id vcrd_011CZkZEMt8gZan2iYOQfSkw

{
  "credential_id": "vcrd_011CZkZEMt8gZan2iYOQfSkw",
  "has_refresh_token": true,
  "mcp_probe": {
    "http_response": {
      "body": "body",
      "body_truncated": true,
      "content_type": "content_type",
      "status_code": 0
    },
    "method": "method"
  },
  "refresh": {
    "http_response": {
      "body": "body",
      "body_truncated": true,
      "content_type": "content_type",
      "status_code": 0
    },
    "status": "succeeded"
  },
  "status": "valid",
  "type": "vault_credential_validation",
  "validated_at": "2026-03-15T10:00:00Z",
  "vault_id": "vlt_011CZkZDLs7fYzm1hXNPeRjv"
}

Returns Examples

{
  "credential_id": "vcrd_011CZkZEMt8gZan2iYOQfSkw",
  "has_refresh_token": true,
  "mcp_probe": {
    "http_response": {
      "body": "body",
      "body_truncated": true,
      "content_type": "content_type",
      "status_code": 0
    },
    "method": "method"
  },
  "refresh": {
    "http_response": {
      "body": "body",
      "body_truncated": true,
      "content_type": "content_type",
      "status_code": 0
    },
    "status": "succeeded"
  },
  "status": "valid",
  "type": "vault_credential_validation",
  "validated_at": "2026-03-15T10:00:00Z",
  "vault_id": "vlt_011CZkZDLs7fYzm1hXNPeRjv"
}