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

# Append PDF vault objects onto an existing PDF vault object

> Merges one or more PDF vault objects onto the end of an existing PDF vault object, overwriting the target in place before returning. Optionally rewrites citation links in the original target into internal PDF jumps and adds back links on appended pages. The target object’s ingestion state is not affected; appended pages are not searchable.



## OpenAPI

````yaml /openapi.json post /vault/{id}/objects/{objectId}/append
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}/objects/{objectId}/append:
    post:
      tags:
        - Vaults
      summary: Append PDF vault objects onto an existing PDF vault object
      description: >-
        Merges one or more PDF vault objects onto the end of an existing PDF
        vault object, overwriting the target in place before returning.
        Optionally rewrites citation links in the original target into internal
        PDF jumps and adds back links on appended pages. The target object’s
        ingestion state is not affected; appended pages are not searchable.
      operationId: appendVaultObject
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Vault ID
        - name: objectId
          in: path
          required: true
          schema:
            type: string
          description: ID of the vault object to append onto
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - appendObjectIds
              properties:
                appendObjectIds:
                  type: array
                  minItems: 1
                  maxItems: 20
                  items:
                    type: string
                  description: >-
                    Vault object IDs whose pages will be appended onto the
                    target object, in order. Must not include the target object
                    itself.
                rewriteLinks:
                  type: boolean
                  default: false
                  description: >-
                    When true, rewrites links in the target object to internal
                    PDF jumps when the URL contains exactly one appended object
                    ID as a standalone query parameter value or decoded path
                    segment.
                backLinks:
                  type: boolean
                  default: false
                  description: Adds back links on appended pages
                backLinksText:
                  type: string
                  default: Back to Summary
                  maxLength: 120
                  description: >-
                    Label text for the back link. Used only when backLinks is
                    true and rendered centered at the bottom of each appended
                    page.
                bates:
                  type: object
                  description: >-
                    Optional Bates stamping for appended source PDFs. Numbering
                    is deterministic across appendObjectIds order and does not
                    stamp the target report pages.
                  properties:
                    enabled:
                      type: boolean
                      default: true
                    prefix:
                      type: string
                      default: ''
                      maxLength: 40
                    suffix:
                      type: string
                      default: ''
                      maxLength: 20
                    start:
                      type: integer
                      default: 1
                      minimum: 1
                    padTo:
                      type: integer
                      default: 0
                      minimum: 0
                      maximum: 12
      responses:
        '200':
          description: Target object updated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  vaultId:
                    type: string
                  filename:
                    type: string
                  contentType:
                    type: string
                  sizeBytes:
                    type: integer
                  checksum:
                    type: string
                  ingestionStatus:
                    type: string
                  pageCount:
                    type: integer
                  objectId:
                    type: string
                  bates:
                    type: object
                  metadata:
                    type: object
                  downloadUrl:
                    type: string
                  expiresIn:
                    type: integer
                  createdAt:
                    type: string
                    format: date-time
        '400':
          description: Invalid request body or unsupported source object format
        '401':
          description: Authentication failed - invalid API key
        '403':
          description: Access denied - API key lacks vault service permissions
        '404':
          description: Vault, target object, or one or more append objects were not found
        '409':
          description: Target object is being ingested or deleted
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key starting with `sk_case_`

````