Document Operations

documents.memories.forEach(d => {
  console.log(d.id, d.title, d.status);
});
```

for doc in documents.memories:
    print(doc.id, doc.title, doc.status)
```

{
  "memories": [
    {
      "id": "doc_abc123",
      "title": "Meeting notes",
      "status": "done",
      "type": "text",
      "createdAt": "2024-01-15T10:30:00Z",
      "containerTags": ["user_123"],
      "metadata": { "source": "slack" }
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 3,
    "totalItems": 25
  }
}

while (true) {
  const { memories, pagination } = await client.documents.list({
    containerTags: [containerTag],
    limit: 100,
    page
  });

  all.push(...memories);
  if (page >= pagination.totalPages) break;
  page++;
}

return all;

</Accordion>

<Accordion title="Filter by Metadata">
```typescript
const documents = await client.documents.list({
  containerTags: ["user_123"],
  filters: {
    AND: [
      { key: "status", value: "reviewed", negate: false },
      { key: "priority", value: "high", negate: false }
    ]
  }
});

console.log(doc.status);  // "queued" | "processing" | "done" | "failed"
console.log(doc.content);
```

print(doc.status)
print(doc.content)
```

  if (doc.status === "done") return doc;
  if (doc.status === "failed") throw new Error("Processing failed");

  await new Promise(r => setTimeout(r, 2000));
}

</Accordion>

---

## Update Document

Update a document's content or metadata. **Content changes** trigger full reprocessing; **metadata-only changes** (e.g. updating `accepted`, `version`) do not reindex.

<Tabs>
<Tab title="TypeScript">
  ```typescript
  await client.documents.update("doc_abc123", {
    content: "Updated content here",
    metadata: { version: 2, reviewed: true }
  });
  ```
</Tab>
<Tab title="Python">
  ```python
  client.documents.update(
      "doc_abc123",
      content="Updated content here",
      metadata={"version": 2, "reviewed": True}
  )
  ```
</Tab>
<Tab title="cURL">
  ```bash
  curl -X PATCH "https://api.supermemory.ai/v3/documents/doc_abc123" \
    -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"content": "Updated content here", "metadata": {"version": 2}}'
  ```
</Tab>
</Tabs>

---

## Delete Documents

Permanently remove documents.

<Tabs>
<Tab title="TypeScript">
  ```typescript
  // Single delete
  await client.documents.delete("doc_abc123");

  // Bulk delete by IDs
  await client.documents.deleteBulk({
    ids: ["doc_1", "doc_2", "doc_3"]
  });

  // Bulk delete by container tag (delete all for a user)
  await client.documents.deleteBulk({
    containerTags: ["user_123"]
  });
  ```
</Tab>
<Tab title="Python">
  ```python
  # Single delete
  client.documents.delete("doc_abc123")

  # Bulk delete by IDs
  client.documents.delete_bulk(ids=["doc_1", "doc_2", "doc_3"])

  # Bulk delete by container tag
  client.documents.delete_bulk(container_tags=["user_123"])
  ```
</Tab>
<Tab title="cURL">
  ```bash
  # Single delete
  curl -X DELETE "https://api.supermemory.ai/v3/documents/doc_abc123" \
    -H "Authorization: Bearer $SUPERMEMORY_API_KEY"

  # Bulk delete by IDs
  curl -X DELETE "https://api.supermemory.ai/v3/documents/bulk" \
    -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"ids": ["doc_1", "doc_2", "doc_3"]}'
  ```
</Tab>
</Tabs>

<Warning>
Deletes are permanent — no recovery.
</Warning>

---

## Processing Queue

Check documents currently being processed.

<Tabs>
<Tab title="TypeScript">
  ```typescript
  const response = await client.documents.listProcessing();
  console.log(`${response.documents.length} documents processing`);
  ```
</Tab>
<Tab title="Python">
  ```python
  response = client.documents.list_processing()
  print(f"{len(response.documents)} documents processing")
  ```
</Tab>
<Tab title="cURL">
  ```bash
  curl "https://api.supermemory.ai/v3/documents/processing" \
    -H "Authorization: Bearer $SUPERMEMORY_API_KEY"
  ```
</Tab>
</Tabs>

---

## Next Steps

- [Memory Operations](/memory-operations) — Advanced v4 memory operations
- [Search](/search) — Query your memories
- [Ingesting Content](/add-memories) — Add new content