Create Encrypted File

Creates an encrypted file on your account.

Encryption details is available here.

Request

HTTP Method: POST

URI Path: /v3/encrypted_files

Header: Content-Type: multipart/form-data

Note

In version 2026-04-16, POST /v3/encrypted_files accepts a single file per request and returns JSON:API-formatted success and error responses.

Request Body Object Attributes

Name	Parameter Type	Type	Is Required?	Description
encrypted_files[encryption_fingerprint]	formData	string	Yes	The encryption fingerprint.
encrypted_files[description]	formData	string	No	The encrypted file description.
encrypted_files[file]	formData	file	Yes	The encrypted file.

Note

• Accepted file formats:

  • .pdf

  • .jpg

  • .png

• You may upload 1 file per request.

• Each file must not exceed 20 MB in size.

• Uploaded encrypted files will expire after 24 hours.

• Legacy batch parameters such as encrypted_files[items][][file] are not supported in version 2026-04-16 and return 400 Bad Request.

Examples

201 Created201 Created Without Description422 Unprocessable Entity (Outdated Fingerprint)422 Unprocessable Entity (Missing File)400 Bad Request (Invalid Params)

http

POST /v3/encrypted_files HTTP/1.1
Host: api.didww.com
Content-Type: multipart/form-data
Accept: application/vnd.api+json
Api-Key: [API token]

curl

curl -i -X POST https://api.didww.com/v3/encrypted_files -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: multipart/form-data"

response

HTTP/1.1 201 Created
Content-Type: application/vnd.api+json

{
    "data": {
        "id": "377dc5cf-55b3-45b8-9fed-156600a7f151",
        "type": "encrypted_files",
        "attributes": {
            "description": "my file",
            "expires_at": "2026-04-07T20:53:11.747Z"
        }
    },
    "meta": {
        "api_version": "2026-04-16"
    }
}

Other Responses

Code	Success	Description
401	No	Unauthorized
400	No	Bad Request Error Object
422	No	Validation Error Object