API Reference

The Nest API is a JSON REST interface designed for speed and security. All endpoints (except public sharing and salt retrieval) require a Bearer JWT Token in the `Authorization` header.

Authentication

POST/auth/salt

Retrieves pre-derivation parameters for a specific email.

{
  "salt": "base64_salt",
  "kdfParams": "{\"algorithm\":\"argon2id\",...}",
  "encryptedMasterKey": "wrapped_blob"
}

POST/auth/login

Authenticates a user session and returns vault keys.

Files & Folders

POST/files/upload

Uploads an encrypted file blob to the network.

GET/files/list

Lists file metadata (encrypted handles only).