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.
idstring
The new API key ID.
secretstring
The full API key secret. Only returned once at creation time.
cloned_fromstring
The ID of the source key that was cloned.
warningstring
Reminder to store the secret securely.
labelstring
environmentstring
scopeslist of strings
created_atdatetime

Errors

401
Unauthorized Error
404
Not Found Error