---
title: "Create decrypt session"
method: POST
path: "/daemon/e2e/sessions"
tags: ["E2E Encryption"]
---

# Create decrypt session

`POST /daemon/e2e/sessions`

Create a temporary, scoped session that allows a remote agent to decrypt
E2E-encrypted chunks through the desktop bridge. Sessions have a TTL,
max chunk limit, and allowed operations.

## Request body

- E2ESessionCreateRequest — Create a scoped decrypt session.
  - `local_folder_id` string, required — E2E source to create session for
  - `ttl_seconds` integer — Session time-to-live in seconds (30s to 1h)
  - `max_chunks` integer — Maximum number of chunks that can be decrypted in this session
  - `allowed_operations` string[] — Operations permitted in this session

## Response `200`

Successful Response

- E2ESessionResponse
  - `id` string, required — Session identifier
  - `local_folder_id` string, required
  - `status` 'active' | 'expired' | 'exhausted', required — Session status: active, expired, or exhausted
  - `created_at` string, date-time, required
  - `expires_at` string, date-time, required
  - `chunks_used` integer, required — Number of chunks decrypted so far
  - `max_chunks` integer, required
  - `allowed_operations` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nozomio-labs/apis/nia-ai-api.md) · [All operations](https://skmtc.net/nozomio-labs/apis/nia-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nozomio-labs/nia-ai-api/versions/dbb602a3ef17/schema)