---
title: "Enrich document"
method: POST
path: "/contents/v1/documents"
tags: ["Documents"]
---

# Enrich document

`POST /contents/v1/documents`

Request a pre-signed URL to upload a document directly to Bigdata.com. The response contains a single-use url and the document id. Send a **PUT request** to that URL with the document file as the body to complete the upload. Bigdata then **enriches** the document (extraction, structure and annotation of the content) and **indexes** it; when done, it is available for the Search and Research Agent.

## Request body

- object
  - `file_name` string, required — Name of the file being uploaded (e.g. research_report.pdf).
  - `published_ts` string, date-time — Optional publication date/time for the document (ISO 8601). This date will be used as the reference timestamp for search and retrieval.
  - `tags` string[] — Optional list of tag names to apply to the document. Tags can be used to search and filter documents in the Search and Research-Agent services.
  - `share_with_org` boolean — If true, all members of your organization can access the file once it is processed. If false, only you can access the processed content.

## Response `200`

Pre-signed URL and document id. PUT the file to the URL to complete the upload; use the id with Get document to poll for status.

- object
  - `url` string, uri, required — Single-use pre-signed URL. Send a PUT request to this URL with the document file as the body.
  - `id` string, required — Document content ID (32-character uppercase hexadecimal). Use this with Get document to check processing status and perform operations on the document.

## Other responses

- `400` — Invalid request body (e.g. missing file_name or invalid format).
- `401` — Unauthorized - Invalid or missing API key.

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)