---
title: "documents.update"
method: POST
path: "/capabilities/documents.update"
tags: ["Capabilities"]
---

# documents.update

`POST /capabilities/documents.update`

Update a single document by ID. Use this for precise corrections to extracted document fields that should not be applied through bulk edit.

## Request body

- object
  - `id` string, required
  - `changes` object, required — Single-document edits. Does not support fromEmail or toEmail.
    - `merchant` string — Vendor/supplier/merchant name shown on the document. Do not use this for 'Billed to'.
    - `amount` number — Document amount in major currency units (for example 12.34)
    - `currency` string
    - `preferredCurrency` Currency — unresolved $ref
    - `docDate` string
    - `category` Merchant — unresolved $ref
    - `docType` 'invoice' | 'receipt' | 'credit_note' | 'quote' | 'purchase_order' | 'order_confirmation'
    - `invoiceId` Merchant — unresolved $ref
    - `receiptId` InvoiceId — unresolved $ref
    - `taxAmount` Amount — unresolved $ref
    - `subtotal` Amount — unresolved $ref
    - `paymentMethod` union
      - 'cash' | 'check' | 'credit_card' | 'debit_card' | 'paypal' | 'bank_transfer' | 'other' | 'unknown'
      - 'null', nullable
    - `paymentMethodEnding` union
      - string
      - 'null', nullable
    - `paymentStatus` 'paid' | 'unpaid' | 'partial' | 'refunded' | 'unknown'
    - `summary` union
      - string
      - 'null', nullable
    - `entityId` union — Legal entity ID assigned to the document. Use entity_list to resolve the entity ID from a business/entity name.
      - string
      - 'null', nullable
    - `labels` string[]
    - `taxRate` number
    - `isRecurring` boolean
    - `recurringType` union
      - 'subscription' | 'retainer' | 'membership' | 'license' | 'lease' | 'installment'
      - 'null', nullable

## Response `200`

Successful response

- object
  - `success` boolean
  - `code` integer
  - `data` object
    - `result` object — Capability-specific result

## Other responses

- `400` — Invalid input
- `401` — Authentication required
- `404` — Resource not found

---

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