v1

latestOpenAPI 3.1.0proprietary2026-07-24156175241.3 KB
Azure Key Vault Accounts

Test Azure Key Vault Connection

Test that OneSchema can authenticate via the configured App Registration and retrieve a specific secret. The secret value is not returned.

post/v0/azure-key-vault/accounts/{account-id}/test

Path parameters

account-idinteger required

The ID of the Azure Key Vault account

Request body

secret_identifierstring required

The identifier of the secret to test retrieval for

vaultstring required

The full Azure Key Vault URL (e.g. https://myvault.vault.azure.net)

secret_versionstring nullable

A specific version to test (omit for latest)

Response

Test result (check the success field)

successboolean
error_codestring

Present when success is false

error_category'account' | 'secret' | 'provider'

Broad classification of the failure. "account" means the account credentials or permissions are wrong; "secret" means the secret identifier or version could not be found; "provider" means a transient infrastructure issue. Present when success is false.

error_messagestring

Present when success is false

request_idstring
transaction_idstring