---
title: "Ingest vault object"
method: POST
path: "/vault/{id}/ingest/{objectId}"
tags: ["Vaults"]
---

# Ingest vault object

`POST /vault/{id}/ingest/{objectId}`

Triggers ingestion workflow for a vault object to extract text, generate chunks, and create embeddings. For supported file types (PDF, DOCX, PPTX, TXT, RTF, XML, HTML, Markdown, CSV/TSV, JSON/YAML/TOML, common source code files, ZIP, audio, video), processing happens asynchronously. ZIP archives are unpacked recursively up to 5 levels, and each extracted file is created as an independent vault object and ingested via the normal pipeline. For unsupported types (images, etc.), the file is marked as completed immediately without text extraction. GraphRAG indexing must be triggered separately via POST /vault/:id/graphrag/:objectId.

## Path parameters

- `id` string, required
- `objectId` string, required

## Response `200`

Ingestion workflow started successfully

- object
  - `objectId` string, required — ID of the vault object being processed
  - `workflowId` string, nullable, required — Workflow run ID for tracking progress. Null for file types that skip processing.
  - `status` 'processing' | 'stored', required — Current ingestion status. 'stored' for file types without text extraction (no chunks/vectors created).
  - `message` string, required — Human-readable status message
  - `enableGraphRAG` boolean, required — Always false - GraphRAG must be triggered separately via POST /vault/:id/graphrag/:objectId

## Other responses

- `400` — Invalid request parameters
- `401` — Invalid or missing API key
- `404` — Vault or object not found

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/versions/5b7e64e6d6f9/schema)