---
title: "Put Document Metadata V3"
method: PUT
path: "/v3/collections/{collection_name}/documents/{document_id}/metadata"
tags: ["file-search"]
---

# Put Document Metadata V3

`PUT /v3/collections/{collection_name}/documents/{document_id}/metadata`

Replace a document's `custom_metadata` with the object in this request; keys omitted here are removed, including from the search filter index. Bulk indexing stamps one metadata object per request, so per-file values (such as an ID from your own system) are set here after indexing.

## Path parameters

- `collection_name` string, required
- `document_id` string, required

## Request body

- UpdateChunkMetadataRequestV3
  - `metadata` UpdateChunkMetadataRequestV3Metadata

## Response `200`

Replace Document Metadata response.

- DocumentMetadataResponseV3 — Response for the document-metadata write endpoints (CAP-659).
  - `custom_metadata` object
  - `document_id` string, required
  - `filterable` boolean
  - `updated_at` string, nullable

---

[API](https://skmtc.dev/runcaptain/apis/api-reference.md) · [All operations](https://skmtc.dev/runcaptain/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runcaptain/api-reference/revisions/fe4649e3f4aa/schema)