API ReferenceDocuments

Update document metadata

Update mutable metadata on a document such as classification, linked session or identity, and custom metadata.

Required scope: documents:write

Authentication

X-API-Keystring

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

Path parameters

document_idstringRequired

Document ID (doc_*).

Headers

Verifa-VersiondateOptional

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

Request

This endpoint expects an object.
classificationstringOptional
Updated document classification.
identity_idstring or nullOptional
Identity ID to link or unlink.
session_idstring or nullOptional
Session ID to link or unlink.
metadatamap from strings to anyOptional

Arbitrary key-value metadata.

statusenumOptional
Manually set document status.
Allowed values:

Response

Document updated.
idstring

Document ID (doc_*).

document_typeenum
Allowed values:
statusenum
Allowed values:
created_atdatetime
org_idstring
Organization ID.
session_idstring or null
Associated session ID, if any.
identity_idstring or null
Associated identity ID, if any.
classificationstring or null

Detected or assigned document classification (e.g. passport, drivers_license).

mime_typestring or null
MIME type of the uploaded file.
file_size_bytesinteger or null
File size in bytes.
original_filenamestring or null
Original filename at upload time.
page_countinteger or null

Number of pages (for multi-page documents).

metadatamap from strings to any

Arbitrary key-value metadata.

upload_sourcestring or null

How the document was uploaded (api, capture, dashboard).

download_urlstring or null

HMAC-signed download URL (when available).

updated_atdatetime or null

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error