API ReferenceAPI Keys

Clone API key

Creates a new API key by copying the settings (scopes, environment, allowed IPs, API version) from an existing key. The new key gets a fresh secret — the original key is not modified.

Important: The full secret is only returned in this response. Store it securely.

Authentication

X-API-Keystring

Organization API key. Keys are prefixed with vk_live_ (production) or vk_sandbox_ (sandbox).

Path parameters

api_key_idstringRequired
The ID of the API key to clone.

Headers

Verifa-VersiondateOptional

API version date string (e.g. 2026-02-01). If omitted, the version pinned to your API key is used.

Response

Cloned API key with the new secret.
idstringOptional
The new API key ID.
secretstringOptional
The full API key secret. Only returned once at creation time.
cloned_fromstringOptional
The ID of the source key that was cloned.
warningstringOptional
Reminder to store the secret securely.
labelstringOptional
environmentstringOptional
scopeslist of stringsOptional
created_atdatetimeOptional

Errors

401
Unauthorized Error
404
Not Found Error