---
title: "Patch Document Metadata"
method: PATCH
path: "/documents/{document_id}/metadata"
tags: ["documents"]
---

# Patch Document Metadata

`PATCH /documents/{document_id}/metadata`

## Path parameters

- `document_id` string, uuid, required — The id of the document.

## Headers

- `partition` string, nullable — An optional partition to scope the request to. If omitted, accounts created after 1/9/2025 will have the request scoped to the default partition, while older accounts will have the request scoped to all partitions. Older accounts may opt in to strict partition scoping by contacting support@ragie.ai. Older accounts using the partitions feature are strongly recommended to scope the request to a partition.

## Request body

- PatchDocumentMetadataParams
  - `metadata` object, required — The metadata to update on the document. Performs a partial update of the document's metadata. Keys must be strings. Values may be strings, numbers, booleans, or lists of strings. Numbers may be integers or floating point and will be converted to 64 bit floating point. Keys set to `null` are deleted. 1000 total values are allowed, inclusive of existing metadata. Each item in an array counts towards the total. The following keys are reserved for internal use: `document_id`, `document_type`, `document_source`, `document_name`, `document_uploaded_at`. If the document is managed by a connection, this operation will extend a metadata overlay which is applied to the document any time the connection syncs the document.
  - `async` boolean — Whether to run the metadata update asynchronously. If true, the metadata update will be run in the background and the response will be 202. If false, the metadata update will be run synchronously and the response will be 200.

## Response `200`

Successful Response

- union
  - DocumentMetadataUpdate
    - `metadata` object, required — The full document metadata inclusive of the update.
  - AsyncDocumentMetadataUpdate
    - `status` string, required

## Other responses

- `401` — Unauthorized
- `402` — Payment Required
- `404` — Not Found
- `422` — Validation Error
- `429` — Too Many Requests
- `500` — Internal Server Error

---

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