# Create Encrypted File

Creates an encrypted file on your account.

Encryption details is available [here](encryption-details.html#encryption-details-v34).

## 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)

[[DIDWW-API-EXAMPLE-START]]

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"
    }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

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": null,
            "expires_at": "2026-04-07T20:53:11.747Z"
        }
    },
    "meta": {
        "api_version": "2026-04-16"
    }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

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 422 Unprocessable Entity
Content-Type: application/vnd.api+json

{
    "errors": [
        {
            "title": "outdated fingerprint",
            "detail": "outdated fingerprint",
            "code": "100",
            "source": {
                "pointer": "/data"
            },
            "status": "422"
        }
    ]
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

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 422 Unprocessable Entity
Content-Type: application/vnd.api+json

{
    "errors": [
        {
            "title": "can't be blank",
            "detail": "file - can't be blank",
            "code": "100",
            "source": {
                "pointer": "/data/attributes/file"
            },
            "status": "422"
        }
    ]
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

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 400 Bad Request
Content-Type: application/vnd.api+json

{
    "errors": [
        {
            "title": "invalid params",
            "detail": "invalid params",
            "code": "400",
            "status": "400"
        }
    ]
}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 401 | No | [Unauthorized](../../../configuration.html#api-key) |
| 400 | No | [Bad Request Error Object](../../../specification/errors/index.html#api-bad-request) |
| 422 | No | [Validation Error Object](../../../specification/errors/index.html#api-validation-error-object) |

On this page