---
title: "Create new document version"
method: POST
path: "/documents/document-put"
tags: ["Document AI — DMS"]
---

# Create new document version

`POST /documents/document-put`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/documents/document-put`
- Auth: HTTP bearer

Versioning is an AI-DMS feature (402 VERSIONING_REQUIRES_AI_DMS unless the source has basic, premium or ultra). Upload a changed file as the NEXT VERSION of an existing document: multipart document-put with UploadFiles[] plus...

This operation has 2 documented variants (same method and path, different fields):
- [Create new document version](https://api.paperoffice.ai/latest/docs/endpoints/po-documents-versions-create.md) — Versioning is an AI-DMS feature (402 VERSIONING_REQUIRES_AI_DMS unless the source has basic, premium or ultra). Upload a changed file as the NEXT VERSION of an existing document: multipart document-put with UploadFiles[] plus...
- [Upload document](https://api.paperoffice.ai/latest/docs/endpoints/po-documents-upload.md) — Upload one or more documents via multipart/form-data or provide a source_url (HTTPS) to fetch a file server-side.

## Response `200`

Success

- SuccessEnvelope: Success envelope. Payload fields are endpoint-specific (top-level fields, `result`/`job_result` for jobs, `data` on some account endpoints).
  - `status` 'success', required
  - `processing_time` union
    - string
    - number
  - `_billing` object

## Other responses

- `4XX`: Error
- `5XX`: Error

---

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