> ## Documentation Index
> Fetch the complete documentation index at: https://docs.case.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Detect privileged content

> Analyzes text or vault documents for legal privilege review. Detects attorney-client privilege, work product doctrine, and common interest privilege.

Returns structured review flags with confidence scores and policy-friendly rationale suitable for discovery workflows and privilege logs. This endpoint is an AI-assisted triage tool and does not replace attorney judgment.

**Size Limit:** Maximum 200,000 characters (larger documents rejected).

**Permissions:** Requires `chat` permission. When using `document_id`, also requires `vault` permission.

**Note:** When analyzing vault documents, results are automatically stored in the document's `privilege_analysis` metadata field.



## OpenAPI

````yaml /openapi.json post /privilege/v1/detect
openapi: 3.1.0
info:
  title: Case.dev API
  description: >-
    The AI-native platform for legal technology. Build smarter legal
    applications with our suite of AI-powered APIs.
  version: 1.0.0
  contact:
    name: Case.dev Support
    email: support@casemark.com
    url: https://case.dev
  license:
    name: Proprietary
    url: https://case.dev/terms
servers:
  - url: https://api.case.dev
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Vaults
    description: Secure document storage with semantic search and GraphRAG
  - name: Memory
    description: >-
      Persistent memory for AI agents with semantic search and 12 generic
      indexed tag fields
  - name: OCR
    description: Extract text from PDFs, images, and scanned documents
  - name: Voice
    description: Audio transcription and text-to-speech
  - name: LLMs
    description: Access 40+ language models through a unified API
  - name: Search
    description: Web search, AI answers, and deep research
  - name: Mail
    description: Managed inboxes for agent email workflows
  - name: Media
    description: Transcript retrieval and captioned media clip generation
  - name: Legal
    description: Legal research tools including citation verification
  - name: Privilege
    description: Privilege detection for e-discovery and litigation workflows
  - name: Compute
    description: Serverless GPU and CPU infrastructure
  - name: Format
    description: Document formatting and template rendering (MD/JSON to PDF/DOCX)
  - name: SuperDoc
    description: Document conversion and template automation
  - name: Webhooks
    description: Webhook endpoint management
  - name: System
    description: Public system metadata and discovery endpoints
  - name: Usage
    description: Usage reporting and webhook subscriptions
  - name: Database
    description: Serverless PostgreSQL databases with instant branching
  - name: Translation
    description: Language detection and translation for multilingual legal workflows
  - name: Skills
    description: Search and read legal AI skills for agents
  - name: Agents
    description: >-
      Create, manage, and execute AI agents with tool access, sandbox
      environments, and async run workflows
  - name: Matters
    description: Matter-native legal workspaces and orchestration primitives
  - name: Applications Projects
    description: Web application project management
  - name: Applications Deployments
    description: Web application deployment management
  - name: Applications Domains
    description: Custom domain configuration for applications
  - name: Applications Env Vars
    description: Environment variable management for applications
paths:
  /privilege/v1/detect:
    post:
      tags:
        - Privilege
      summary: Detect privileged content
      description: >-
        Analyzes text or vault documents for legal privilege review. Detects
        attorney-client privilege, work product doctrine, and common interest
        privilege.


        Returns structured review flags with confidence scores and
        policy-friendly rationale suitable for discovery workflows and privilege
        logs. This endpoint is an AI-assisted triage tool and does not replace
        attorney judgment.


        **Size Limit:** Maximum 200,000 characters (larger documents rejected).


        **Permissions:** Requires `chat` permission. When using `document_id`,
        also requires `vault` permission.


        **Note:** When analyzing vault documents, results are automatically
        stored in the document's `privilege_analysis` metadata field.
      operationId: detectPrivilege
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                content:
                  type: string
                  description: >-
                    Text content to analyze (required if document_id not
                    provided)
                document_id:
                  type: string
                  description: >-
                    Vault object ID to analyze (required if content not
                    provided)
                vault_id:
                  type: string
                  description: Vault ID (required when using document_id)
                categories:
                  type: array
                  items:
                    type: string
                    enum:
                      - attorney_client
                      - work_product
                      - common_interest
                  description: >-
                    Privilege categories to check. Defaults to all:
                    attorney_client, work_product, common_interest
                jurisdiction:
                  type: string
                  enum:
                    - US-Federal
                  default: US-Federal
                  description: Jurisdiction for privilege rules
                include_rationale:
                  type: boolean
                  default: true
                  description: Include detailed rationale for each category
                model:
                  type: string
                  default: casemark/core-large
                  description: LLM model to use for analysis
      responses:
        '200':
          description: Privilege analysis completed
          content:
            application/json:
              schema:
                type: object
                required:
                  - privileged
                  - confidence
                  - categories
                  - recommendation
                  - policy_rationale
                properties:
                  privileged:
                    type: boolean
                    description: Whether any privilege was detected
                  confidence:
                    type: number
                    minimum: 0
                    maximum: 1
                    description: Overall confidence score (0-1)
                  categories:
                    type: array
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                          description: Privilege category
                        detected:
                          type: boolean
                          description: Whether this privilege type was detected
                        confidence:
                          type: number
                          description: Confidence for this category (0-1)
                        rationale:
                          type: string
                          description: Explanation of detection result
                        indicators:
                          type: array
                          items:
                            type: string
                          description: Specific phrases or patterns found
                  recommendation:
                    type: string
                    enum:
                      - withhold
                      - redact
                      - produce
                      - review
                    description: Recommended action for discovery
                  policy_rationale:
                    type: string
                    description: Policy-friendly explanation for privilege log
        '400':
          description: >-
            Invalid request - missing content/document_id or content exceeds
            size limit
        '401':
          description: Invalid API key
        '403':
          description: API key does not have access to chat service
        '404':
          description: Vault or document not found
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key starting with `sk_case_`

````