Cases

Create a case (retention_mode REQUIRED, no default) · 2 credits

Opens a case (a persistent or ephemeral RAG workspace). 🔴 retention_mode is ALWAYS chosen explicitly (400 MISSING_RETENTION_MODE if absent): a persistent default would persist without permission and an ephemeral default would silently purge evidence — the only safe absence is not creating the case. Single debit here (2 cr expediente_open); the insert is rolled back if the debit fails. Supports Idempotency-Key (per-user encrypted cache). pii_gatekeeper:"off" requires account consent (403 PII_OPTOUT_NOT_ENABLED). Scope: cases | mcp | *.

post/api/v1/cases

Request

  • Base URL: https://legal.nexusquantum.legal
  • URL: https://legal.nexusquantum.legal/api/v1/cases
  • Auth: HTTP bearer

Request body

namestring required

ZR recommendation: use your external matter ID, not personal data.

retention_mode'persistent' | 'ephemeral' required

Lifecycle of the case SOURCE documents. REQUIRED, WITH NO DEFAULT, when creating through the API: persistent = sources are kept until explicitly deleted (firm archive); ephemeral = sources are PURGED when ephemeral_ttl_hours expires (sliding: reset on every ingest). The choice is audited (created_via=api). GDPR Art. 25 / Art. 5(1)(e).

ephemeral_ttl_hoursinteger

Only with ephemeral; with persistent → 400 TTL_WITHOUT_EPHEMERAL (never silently ignored).

descriptionstring
jurisdictionstring

Optional (ISO). NEVER defaulted.

pii_gatekeeper'on' | 'off'

Response

{ case: Case, inbound_alias, credits_charged: 2 }

Changes

No recorded changes to this operation across all 1 revision of this API.