---
title: "Describe a Document Before an Entity is Created"
method: POST
path: "/documents"
tags: ["Documents"]
---

# Describe a Document Before an Entity is Created

`POST /documents`

## Request body

- object
  - `name` string, required
  - `extension` string, required
  - `type` string, required
  - `note` string
  - `note_author_agent_email` string

## 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)