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

# Get vault information

> Retrieve detailed information about a specific vault, including storage configuration, chunking strategy, and usage statistics. Returns vault metadata, bucket information, and vector storage details.



## OpenAPI

````yaml /openapi.json get /vault/{id}
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}:
    get:
      tags:
        - Vaults
      summary: Get vault information
      description: >-
        Retrieve detailed information about a specific vault, including storage
        configuration, chunking strategy, and usage statistics. Returns vault
        metadata, bucket information, and vector storage details.
      operationId: getVault
      parameters:
        - name: id
          in: path
          required: true
          description: Unique identifier of the vault
          schema:
            type: string
          example: vault_abc123
      responses:
        '200':
          description: Vault information retrieved successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - name
                  - filesBucket
                  - region
                  - createdAt
                properties:
                  id:
                    type: string
                    description: Vault identifier
                  name:
                    type: string
                    description: Vault name
                  description:
                    type: string
                    description: Vault description
                  filesBucket:
                    type: string
                    description: S3 bucket for document storage
                  vectorBucket:
                    type: string
                    nullable: true
                    description: S3 bucket for vector embeddings
                  indexName:
                    type: string
                    description: Search index name
                  region:
                    type: string
                    description: AWS region
                  kmsKeyId:
                    type: string
                    description: KMS key for encryption
                  chunkStrategy:
                    type: object
                    description: Document chunking strategy configuration
                    properties:
                      method:
                        type: string
                        description: Chunking method (e.g., 'semantic', 'fixed')
                      overlap:
                        type: integer
                        description: Number of overlapping tokens between chunks
                      chunkSize:
                        type: integer
                        description: Target size for each chunk in tokens
                      minChunkSize:
                        type: integer
                        description: Minimum chunk size in tokens
                  enableGraph:
                    type: boolean
                    description: Whether GraphRAG is enabled
                  totalObjects:
                    type: integer
                    description: Number of stored documents
                  totalBytes:
                    type: integer
                    description: Total storage size in bytes
                  totalVectors:
                    type: integer
                    description: Number of vector embeddings
                  metadata:
                    type: object
                    description: Additional vault metadata
                  createdAt:
                    type: string
                    format: date-time
                    description: Vault creation timestamp
                  updatedAt:
                    type: string
                    format: date-time
                    description: Last update timestamp
              example:
                id: vault_abc123
                name: Contract Repository
                description: Secure storage for client contracts and legal documents
                filesBucket: case-vault-files-abc123
                vectorBucket: case-vault-vectors-abc123
                indexName: contracts-index
                region: us-east-1
                kmsKeyId: >-
                  arn:aws:kms:us-east-1:123456789:key/12345678-1234-1234-1234-123456789012
                chunkStrategy:
                  method: semantic
                  overlap: 50
                  chunkSize: 512
                  minChunkSize: 100
                enableGraph: true
                totalObjects: 1247
                totalBytes: 2847362048
                totalVectors: 45623
                metadata:
                  vectorBucket: case-vault-vectors-abc123
                  lastIndexed: '2024-01-15T10:30:00Z'
                createdAt: '2024-01-01T00:00:00Z'
                updatedAt: '2024-01-15T10:30:00Z'
        '400':
          description: Invalid vault ID provided
        '401':
          description: Invalid API key
        '403':
          description: API key does not have vault service access
        '404':
          description: Vault not found or access denied
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key starting with `sk_case_`

````