> ## 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.

# Draft a legal document

> Generate a legal document with structured inputs. Powered by an agent that handles research, formatting, citation verification, and vault upload. Returns a run ID for polling.



## OpenAPI

````yaml /openapi.json post /legal/v1/draft
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:
  /legal/v1/draft:
    post:
      tags:
        - Legal
      summary: Draft a legal document
      description: >-
        Generate a legal document with structured inputs. Powered by an agent
        that handles research, formatting, citation verification, and vault
        upload. Returns a run ID for polling.
      operationId: draftLegalDocument
      requestBody:
        description: Structured drafting parameters
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - instructions
                - vault_id
              properties:
                instructions:
                  type: string
                  description: >-
                    What to draft — the core task. E.g., "Motion to compel
                    defendant to produce discovery responses"
                  minLength: 10
                  maxLength: 50000
                output_type:
                  type: string
                  enum:
                    - pdf
                    - docx
                    - xlsx
                    - pptx
                    - md
                  default: md
                  description: Output file format
                output_name:
                  type: string
                  description: Filename for the output document. Auto-generated if omitted.
                  nullable: true
                length:
                  type: object
                  nullable: true
                  description: Target document length
                  properties:
                    target:
                      type: number
                      description: Target value (e.g., 2000 words or 5 pages)
                    unit:
                      type: string
                      enum:
                        - words
                        - pages
                      default: words
                      description: Whether the target length is measured in words or pages
                citations:
                  type: boolean
                  default: false
                  description: Research and include legal citations
                format:
                  type: string
                  nullable: true
                  description: >-
                    Court or jurisdiction formatting hint. Triggers a
                    legal-skills search. E.g., "California Superior Court",
                    "SDNY", "federal pleading"
                verified:
                  type: boolean
                  default: false
                  description: >-
                    Verify all citations in a loop — re-run verification and
                    repair bad citations until they pass
                vault_id:
                  type: string
                  description: Vault ID where the final document will be uploaded
                object_ids:
                  type: array
                  items:
                    type: string
                  nullable: true
                  description: Vault object IDs to use as source/reference documents
                model:
                  type: string
                  nullable: true
                  description: LLM model override. Defaults to anthropic/claude-sonnet-4.6
      responses:
        '200':
          description: Draft run started
          content:
            application/json:
              schema:
                type: object
                properties:
                  run_id:
                    type: string
                    description: Run ID — poll /agent/v1/run/:id/status for progress
                  agent_id:
                    type: string
                    description: Ephemeral agent ID
                  status:
                    type: string
                    enum:
                      - running
                  message:
                    type: string
        '400':
          description: Invalid request parameters
        '401':
          description: Invalid API key
        '403':
          description: Insufficient permissions
        '404':
          description: Vault not found
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key starting with `sk_case_`

````