---
title: "Update Imported Document"
method: PATCH
path: "/v1/documents"
---

# Update Imported Document

`PATCH /v1/documents`

Partially update an imported document.

Requires the **Import** permission (`ingest` scope). Supplying `url` or
`content` creates a new version and reprocesses the document; omitting both
performs a metadata-only update. The author cannot be changed.

## Query parameters

- `remoteId` string, required
- `sourceId` string, uuid, required

## Request body

- UpdateDocumentRequest — Partial update for a document, identified by ``source_id`` and ``remote_id``. Source can be supplied as ``url`` OR ``content`` (base64), not both. A PATCH with neither is a metadata-only update (display_name, owners, …). A source change (different URL, or ``content`` supplied) creates a new document version and reprocesses the document. ``author`` is intentionally not updatable: it's set at ingest time and may be linked to a Sybill person. Callers that need to change the author should delete and re-ingest.
  - `version` integer
  - `displayName` string, nullable
  - `public` boolean, nullable
  - `ownerEmails` string[], nullable
  - `updatedAt` union
    - string
    - integer
    - number
  - `url` string, nullable
  - `content` string, nullable
  - `filename` string, nullable
  - `contentType` string, nullable

## Response `200`

Successful Response

- RecordResponse
  - `status` 'created' | 'updated', required
  - `recordId` string, required
  - `id` string, required
  - `sourceId` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sybill/apis/sybill-api.md) · [All operations](https://skmtc.net/sybill/apis/sybill-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sybill/sybill-api/revisions/f499ec011b17/schema)