---
title: "Document Status Change with Upload"
method: PATCH
path: "/public/v1/documents/{id}/status?upload"
tags: ["Documents"]
---

# Document Status Change with Upload

`PATCH /public/v1/documents/{id}/status?upload`

PandaDoc has eight document statuses, but you can manually set your document status to only four:

### Document statuses

- Completed - `document.completed` - API code `2`
- Expired - `document.voided` - code `11`
- Paid - `document.paid` - code `10`. **Important**: You can only set it if you have a payment app connected.
- Declined - `document.declined` - code `12`

> 🚧 Pass a numeric code for the corresponding document status, for example, `2` for `document.completed`.

Find more details in [\[Editor 2.0\] Manually change document status](https://support.pandadoc.com/en/articles/9714842-manually-change-document-status) topic.

| Current Status | To Completed: | To Expired: | To Paid: | To Declined: |
|----------------|---------------|-------------|----------|--------------|
| Draft          | YES           | NO          | YES      | YES          |
| Approved       | NO            | NO          | NO       | NO           |
| Sent           | YES           | YES         | NO       | YES          |
| Viewed         | YES           | YES         | NO       | YES          |
| Completed (Auto) | NO          | NO          | NO       | YES          |
| Waithing for payment | NO      | NO          | YES      | YES          |
| Paid           | NO            | NO          | NO       | NO           |
| Expired        | YES           | NO          | YES      | YES          |
| Declined       | YES           | NO          | YES      | NO           |

> ✅ - from `document.voided` to `document.paid`
>
> ❌ - from `document.paid` to `document.voided`

## Path parameters

- `id` string, required

## Response `204`

No content

## Other responses

- `401` — Authentication error
- `403` — Permission error
- `404` — Not found
- `409` — Conflict
- `423` — Document is locked for editing
- `429` — Too Many Requests

---

[API](https://skmtc.net/pandadoc/apis/pandadoc-public-api.md) · [All operations](https://skmtc.net/pandadoc/apis/pandadoc-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pandadoc/pandadoc-public-api/versions/0c2b70be3fb0/schema)