## Upload a file

**post** `/v3/documents/file`

Upload a file to be processed

### Returns

- `id: string`

  Unique identifier of the document

- `status: string`

  Status of the document

### Example

```http
curl https://api.supermemory.ai/v3/documents/file \
    -H 'Content-Type: multipart/form-data' \
    -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
    -F 'file=@/path/to/file' \
    -F containerTag=user \
    -F customId=mem_abc123 \
    -F entityContext="User's name is {XYZ}" \
    -F filepath=/documents/reports/file.pdf \
    -F fileType=image \
    -F filterByMetadata='{"department": "engineering"}' \
    -F metadata='{"category": "technology", "isPublic": true, "readingTime": 5}' \
    -F taskType=memory \
    -F useAdvancedProcessing=true
```

#### Response

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