---
title: "Initiate a documents upload"
method: POST
path: "/documents/upload/initiate"
tags: ["Documents"]
---

# Initiate a documents upload

`POST /documents/upload/initiate`

## Request

- Base URL: `https://api.surense.com/api/v1`
- URL: `https://api.surense.com/api/v1/documents/upload/initiate`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.surense.com/oauth/token`

## Request body

- InitiateUploadDocumentsRequest
  - `documents` DocumentEntry[]
    - `docId` string, required: Document ID
    - `inline` boolean, required: Whether to display the document inline
    - `shorten` boolean, required: Whether to shorten the URL

## Response `200`

OK

- InitiateUploadDocumentsResponse
  - `results` Result[]
    - `id` string, uuid
    - `name` string
    - `duplicateDocId` string, uuid
    - `duplicateDocName` string

---

[API](https://skmtc.dev/surense/apis/document-api.md) - [All operations](https://skmtc.dev/surense/apis/document-api/llms.txt) - [OpenAPI document](https://skmtc.dev/surense/apis/document-api/revisions/92cbf89acb6f?raw)