---
title: "Update vault object"
method: PATCH
path: "/vault/{id}/objects/{objectId}"
tags: ["Vaults"]
---

# Update vault object

`PATCH /vault/{id}/objects/{objectId}`

Update a document's filename, path, or metadata. Use this to rename files or organize them into virtual folders. The path is stored in metadata.path and can be used to build folder hierarchies in your application.

## Path parameters

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

## Request body

- object
  - `filename` string — New filename for the document (affects display name and downloads)
  - `path` string, nullable — Folder path for hierarchy preservation (e.g., '/Discovery/Depositions'). Set to null or empty string to remove.
  - `metadata` object — Additional metadata to merge with existing metadata

## Response `200`

Object updated successfully

- object
  - `id` string — Object ID
  - `vaultId` string — Vault ID
  - `filename` string — Updated filename
  - `path` string, nullable — Folder path for hierarchy preservation
  - `contentType` string — MIME type
  - `sizeBytes` integer — File size in bytes
  - `ingestionStatus` string — Processing status
  - `metadata` object — Full metadata object
  - `updatedAt` string, date-time — Last update timestamp

## Other responses

- `400` — Invalid request - no fields to update or invalid field values
- `401` — Invalid API key
- `403` — API key does not have vault service access
- `404` — Object not found
- `409` — Object is currently being processed and cannot be updated

---

[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)