Skip to main content

Files

Files are PDF documents uploaded to DokStamp before being attached to certificates or documents. Each file can only be used by one certificate — once attached, it is marked as used and cannot be reused.

The file object


Upload files

Accepts multipart/form-data. You can upload multiple files in a single request.
Response 201:

List files

Filter for unused files (available to attach to new certificates):

Get file metadata


Download a file

This endpoint is public — no Authorization header required. Share this URL directly with signers, students, or employers.

Update file metadata


Delete a file

You cannot delete a file that is already attached to a certificate (used_at is not null). Delete or revoke the certificate first.

Deduplication

The API computes a hash for each uploaded file. If you upload the same file content twice, the second upload returns the existing file record instead of creating a duplicate. This prevents storage bloat in batch upload workflows.