---
title: "Upload Document"
method: POST
path: "/business/v2/documents/upload"
tags: ["Documents"]
---

# Upload Document

`POST /business/v2/documents/upload`

## Request

- Base URL: `https://api.soldo.com`
- URL: `https://api.soldo.com/business/v2/documents/upload`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.soldo.com/oauth/authorize` scopes: `document_write`
- TypeScript: <https://skmtc.dev/soldo/apis/soldo-business-api-v2-0/docs/business/v2/documents/upload/post.ts> (a function with typed inputs; its response is checked against the schema)

Endpoint to upload a `Document`.The first step is to get a temporary URL where to upload the file.

## Request body `application/x-www-form-urlencoded`

- UploadDocument: Parameters used to request a temporary document upload URL.
  - `content_type` string, required: The MIME type of the `Document`.
  - `file_extension` string, required: The file extension of the `Document`.

## Response `200`

The returned resource is a single `UploadUrlDocument`.

- UploadUrlDocument
  - `uploaded_by` string: The User or system that uploaded the file of the `Document`
  - `operation_type` 'UPLOAD_URL' | 'UPLOAD_COMPLETED'
  - `content_type` string: The MIME type of the `Document`.
  - `attachment_name` string: Attachment name of the `Document`
  - `pre_signed_url` string: Pre-signed URL of the `Document`

## Other responses

- `400`: Your request has missing arguments or is malformed.
- `404`: One or more resource requested does not exist.

## Changes

- **2026-08-06** `7be21448a2b3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/soldo/apis/soldo-business-api-v2-0/changes/business/v2/documents/upload/post.md)

---

[API](https://skmtc.dev/soldo/apis/soldo-business-api-v2-0.md) - [All operations](https://skmtc.dev/soldo/apis/soldo-business-api-v2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/soldo/apis/soldo-business-api-v2-0/revisions/23fc5d07b367?raw)