---
title: "Describe a Document Before Uploading"
method: POST
path: "/entities/{entity_token}/documents"
tags: ["Documents"]
---

# Describe a Document Before Uploading

`POST /entities/{entity_token}/documents`

The document upload API is a two-step process. First, the metadata for the document is specified, and the API returns a file identifier so the file can be streamed directly to the next endpoint. You’ll need to look for the document_token returned in the response because that is necessary to pass to the next endpoint for streaming the file.

## Request body

- Schema — unresolved $ref

## Response `200`

Document

- Items — unresolved $ref

---

[API](https://skmtc.dev/alloy/apis/alloy-api.md) · [All operations](https://skmtc.dev/alloy/apis/alloy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alloy/alloy-api/revisions/405799de4d2a/schema)