---
title: "Updates metadata for multiple invoices"
method: POST
path: "/invoices/metadata/bulk"
tags: ["Invoices"]
---

# Updates metadata for multiple invoices

`POST /invoices/metadata/bulk`

## Request

- Base URL: `https://api.rillet.com`
- URL: `https://api.rillet.com/invoices/metadata/bulk`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/rillet/apis/rillet-accounting-api/docs/invoices/metadata/bulk/post.ts> (a function with typed inputs; its response is checked against the schema)

Patches metadata on up to 1,000 invoices in one atomic request. Each invoice may receive
different values. If an invoice is missing or any key or value is invalid, nothing is
written for any invoice. Per invoice this behaves exactly like patch-invoice-metadata:
keys omitted for that invoice are left unchanged; null, empty, and whitespace-only values
clear that key.

## Request body

- BulkUpdateInvoiceMetadataRequest
  - `invoices` BulkInvoiceMetadataUpdate[], required
    - `invoice_id` string, uuid, required
    - `metadata` object, required: Partial update for this invoice. Omitted keys are left unchanged; null or empty values clear a key.

## Response `200`

OK

- BulkUpdateInvoiceMetadataResponse
  - `invoices` BulkInvoiceMetadataResult[], required
    - union
      - AppliedInvoiceMetadataResult
        - `invoice_id` string, uuid, required
        - `metadata` object, required
      - InvoiceUpdateProposal: Proposed edits awaiting approval. These changes have not been applied to the invoice.
        - `invoice_id` string, uuid, required
        - `approval_request_id` string, uuid, required
        - `status` 'PENDING', required

## Other responses

- `default`: Error

## Changes

- **2026-11-03** `c393d0102005`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rillet/apis/rillet-accounting-api/changes/invoices/metadata/bulk/post.md)

---

[API](https://skmtc.dev/rillet/apis/rillet-accounting-api.md) - [All operations](https://skmtc.dev/rillet/apis/rillet-accounting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rillet/apis/rillet-accounting-api/revisions/c393d0102005?raw)