Client encryption helper

POST

/api/v1/zk/encrypt

Helper endpoint for testing. In production, encryption should happen client-side using the same algorithm.

Encrypts code with Argon2id + XChaCha20-Poly1305. Returns an opaque payload to store via PUT /api/v1/zk/code/:name.

Note: This endpoint exists for convenience. For true zero-knowledge, encrypt on the client.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Encrypted payload

Body

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/zk/encrypt' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "masterPassword": "MyS3cur3P@ss!",
    "code": "print('\''Hello from zero-knowledge!'\'')"
}'

Response Example

200 - Example 1

{
    "encryptedPayload": {
        "v": 1,
        "salt": "string",
        "nonce": "string",
        "ciphertext": "string"
    }
}

Modified at 2026-04-04 08:23:30

Remove a package

Store encrypted code