Decrypt and execute in sandbox

POST

/api/v1/zk/execute/{name}

Execute encrypted code. The server never decrypts your code. The master password is passed directly to the isolated sandbox as an environment variable. Decryption (Argon2id + XChaCha20-Poly1305) happens only inside the sandbox.

What the server sees: encrypted blob in, stdout/stderr out.
What the server does NOT see: your source code.

The sandbox installs argon2-cffi + pynacl (Python) or argon2 + @noble/ciphers (JS), derives the key from your master password, decrypts, and executes.

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: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Code decrypted and executed inside sandbox

Body

🟠403

🟠404

🟠400BadRequest

🟠401Unauthorized

🟠429RateLimited

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/zk/execute/' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "masterPassword": "MyS3cur3P@ss!",
    "packages": [
        "requests"
    ]
}'

Response Example

200 - Success

{
    "output": "Hello from zero-knowledge!\n",
    "error": "",
    "exitCode": 0,
    "language": "python",
    "zeroKnowledge": true
}

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

List encrypted code

AuthRequest