---
title: "Inject customer metadata for documents"
method: POST
path: "/v1/inject-customer-metadata"
tags: ["Documents"]
---

# Inject customer metadata for documents

`POST /v1/inject-customer-metadata`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/inject-customer-metadata`
- Auth: HTTP bearer

Upload a CSV file containing customer-provided metadata fields and attach
those values to matching documents.

By default, the endpoint expects a comma-delimited UTF-8 CSV with a
`document_id` column. Every non-empty column other than `document_id`
is written as injected metadata. Pass `reference_column`, `delimiter`,
`encoding`, or `field_columns` to use another CSV layout.

## Response `200`

Metadata injection completed.

- object
  - `batch_id` string, uuid, required
  - `rows_processed` integer, required
  - `documents_matched` integer, required
  - `documents_pending` integer, required
  - `fields_written` integer, required

## Other responses

- `400`: The request is invalid.
- `401`: Missing or invalid API key.
- `403`: The API key does not have the required scope.
- `413`: The uploaded file exceeds the size limit.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)