---
title: "Update the status of document"
method: PUT
path: "/core/latest/print-partners/document-status"
tags: ["Print partner"]
---

# Update the status of document

`PUT /core/latest/print-partners/document-status`

## Request

- Base URL: `https://api.klara.ch`
- URL: `https://api.klara.ch/core/latest/print-partners/document-status`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

To update the status of physical document using by print partner

## Request body

- PrintPartnerStatusModel
  - `updates` UpdateModel[], required
    - `externalDocumentId` string: External document Id. ExternalDocumentId or letterId must be provided.
    - `status` 'RECEIVED' | 'READY' | 'SENDING' | 'FINISHED' | 'ERROR' | 'UNDELIVERABLE', required: status of document
    - `letterId` string: Letter id was printed and packed the letter in an envelope. ExternalDocumentId or letterId must be provided.
    - `errorMessage` string

## Response `200`

OK

- PrintPartnerStatusModel
  - `updates` UpdateModel[], required
    - `externalDocumentId` string: External document Id. ExternalDocumentId or letterId must be provided.
    - `status` 'RECEIVED' | 'READY' | 'SENDING' | 'FINISHED' | 'ERROR' | 'UNDELIVERABLE', required: status of document
    - `letterId` string: Letter id was printed and packed the letter in an envelope. ExternalDocumentId or letterId must be provided.
    - `errorMessage` string

## Other responses

- `400`: Invalid request body or fail validation<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `401`: No Authorization header found or invalid token<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `403`: The current user is not allowed to access this company data<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.

---

[API](https://skmtc.dev/klara/apis/klara-public-api.md) · [All operations](https://skmtc.dev/klara/apis/klara-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/klara/apis/klara-public-api/revisions/490b1a879fc2?raw)