For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • Getting Started
    • Introduction
    • How Verifa Works
    • Quickstart
    • Choosing an Integration Method
  • Use Cases
    • KYC Onboarding
    • Age Verification
    • AML Compliance
    • Fraud Prevention
    • Marketplace Trust & Safety
  • Core Concepts
    • Overview
    • Sessions
    • Verifications & Checks
    • Workflows
    • Identities
    • Cases
    • Screening & Reports
    • Lists
  • Integration Guides
    • Overview
    • JavaScript SDK
    • Web Capture Flow
    • API-Only Integration
    • Mobile SDK
    • Webhooks Guide
    • MCP Server
    • Migrating from Persona
  • API Details
    • Overview
    • Authentication
    • Pagination
    • Rate Limiting
    • Versioning
    • Errors
    • Webhooks
    • Idempotency
    • Key Inflection
    • Data Access
    • Data Retention
  • Tutorials
    • Creating Your First Verification Session
    • Creating a Workflow
    • Receiving Webhooks & Validating Signatures
    • Handling Webhook Events
    • Custom Document Types & AI Extraction
  • Best Practices
    • Testing
    • Preventing Duplicates
    • Fraud Signals
    • Changelog
  • API Reference
      • GETList API keys
      • POSTCreate API key
      • GETRetrieve API key
      • PATCHUpdate API key
      • POSTExpire API key
      • POSTClone API key
      • GETGet rate limit status
API ReferenceAPI Keys

Clone API key

POST
https://devapi.withverifa.com/api/v1/api-keys/:api_key_id/clone
POST
/api/v1/api-keys/:api_key_id/clone
$curl -X POST https://devapi.withverifa.com/api/v1/api-keys/api_key_id/clone \
>     -H "X-API-Key: <apiKey>"
1{
2  "id": "string",
3  "secret": "string",
4  "cloned_from": "string",
5  "warning": "string",
6  "label": "string",
7  "environment": "string",
8  "scopes": [
9    "string"
10  ],
11  "created_at": "2024-01-15T09:30:00Z"
12}

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.

Was this page helpful?
Previous

Get rate limit status

Next
Built with

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