## Add document

**post** `/v3/documents`

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

### Body Parameters

- `content: string`

  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: optional string`

  Optional tag this document should be containerized by. Max 100 characters, alphanumeric with hyphens, underscores, and dots only.

- `containerTags: optional array of string`

- `customId: optional string`

  Optional custom ID of the document. Max 100 characters, alphanumeric with hyphens, underscores, and dots only.

- `entityContext: optional string`

  Optional entity context for this container tag. Max 1500 characters. Used during document processing to guide memory extraction.

- `filepath: optional string`

  Optional file path for the document. Used by supermemoryfs to store the full path of the file.

- `filterByMetadata: optional map[string or number or boolean or array of string]`

  Optional metadata filter to apply when pulling related memories and profile during ingestion. Only memories matching these filters will be used as context.

  - `string`

  - `number`

  - `boolean`

  - `array of string`

- `metadata: optional map[string or number or boolean or array of string]`

  Optional metadata for the document.

  - `string`

  - `number`

  - `boolean`

  - `array of string`

- `taskType: optional "memory" or "superrag"`

  Task type: "memory" (default) for full context layer with SuperRAG built in, "superrag" for managed RAG as a service.

  - `"memory"`

  - `"superrag"`

### Returns

- `id: string`

  Unique identifier of the document

- `status: string`

  Status of the document

### Example

```http
curl https://api.supermemory.ai/v3/documents \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
    -d '{
          "content": "content"
        }'
```

#### Response

```json
{
  "id": "id",
  "status": "status"
}
```