---
title: "Add document"
method: POST
path: "/v3/documents"
tags: ["Manage Documents"]
---

# Add document

`POST /v3/documents`

Add a document with any content type (text, url, file, etc.) and metadata

## Request body

- object
  - `content` string, required — The content to extract and process into a document. This can be a URL to a website, a PDF, an image, or a video.
  - `containerTag` string — Optional tag this document should be containerized by. Max 100 characters, alphanumeric with hyphens and underscores only.
  - `containerTags` string[]
  - `entityContext` string — Optional entity context for this container tag. Max 1500 characters. Used during document processing to guide memory extraction.
  - `customId` string — Optional custom ID of the document. Max 100 characters, alphanumeric with hyphens and underscores only.
  - `metadata` object — Optional metadata for the document.

## Response `200`

Document added successfully

- object
  - `id` string, required — Unique identifier of the document
  - `status` string, required — Status of the document

## Other responses

- `401` — Unauthorized
- `500` — Internal server error

## Changes

- **2026-02-03** `c52fac62512b` — 1 info
  - added the new optional request property `entityContext`

[Change history](https://skmtc.dev/supermemoryai/apis/supermemory-api/changes/v3/documents/post.md)

---

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