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

# Initiate multipart upload for vault file

> Initiate a multipart upload for large files (>5GB). Single PUT uploads are capped at 5GB; multipart default max is 16GB (configurable). Multipart uploads are supported in production. Returns an uploadId and object metadata. Use part URLs endpoint to upload parts and complete endpoint to finalize.



## OpenAPI

````yaml /openapi.json post /vault/{id}/multipart/init
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:
  /vault/{id}/multipart/init:
    post:
      tags:
        - Vaults
      summary: Initiate multipart upload for vault file
      description: >-
        Initiate a multipart upload for large files (>5GB). Single PUT uploads
        are capped at 5GB; multipart default max is 16GB (configurable).
        Multipart uploads are supported in production. Returns an uploadId and
        object metadata. Use part URLs endpoint to upload parts and complete
        endpoint to finalize.
      operationId: initVaultMultipartUpload
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Vault ID to upload the file to
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - filename
                - contentType
                - sizeBytes
              properties:
                filename:
                  type: string
                  description: Name of the file to upload
                contentType:
                  type: string
                  description: MIME type of the file
                sizeBytes:
                  type: integer
                  minimum: 1
                  description: >-
                    File size in bytes (required, default max 16GB). Configure
                    via VAULT_MULTIPART_MAX_FILE_SIZE_BYTES.
                partSizeBytes:
                  type: integer
                  minimum: 5242880
                  maximum: 5368709120
                  description: >-
                    Multipart part size in bytes (min 5MB, max 5GB). Defaults to
                    64MB.
                metadata:
                  type: object
                  description: Additional metadata to associate with the file
                auto_index:
                  type: boolean
                  default: true
                  description: >-
                    Whether to automatically process and index the file for
                    search
                is_ai_generated:
                  type: boolean
                  default: false
                  description: >-
                    Marks the file as AI-generated work product (e.g. uploaded
                    by an agent) rather than a user-provided source document.
                    Persisted on the object and returned by object listings so
                    clients can distinguish provenance.
                path:
                  type: string
                  description: Optional folder path for hierarchy preservation
      responses:
        '200':
          description: Multipart upload initiated
          content:
            application/json:
              schema:
                type: object
                properties:
                  objectId:
                    type: string
                  uploadId:
                    type: string
                  s3Key:
                    type: string
                  partSizeBytes:
                    type: integer
                  partCount:
                    type: integer
                  next_step:
                    type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key starting with `sk_case_`

````