---
title: "Update a memory"
method: POST
path: "/memories/update/{source}/{resource_id}"
tags: ["Memories"]
---

# Update a memory

`POST /memories/update/{source}/{resource_id}`

Updates an existing document in the index. You can update the text, collection,
title, and metadata. The document must already exist or a 404 will be returned.
This works for documents from any source (vault, slack, gmail, etc.).

To remove a collection, set it to null explicitly.

## Path parameters

- `source` 'reddit' | 'notion' | 'slack' | 'google_calendar' | 'google_mail' | 'box' | 'dropbox' | 'github' | 'google_drive' | 'vault' | 'web_crawler' | 'trace' | 'microsoft_teams' | 'gmail_actions' | 'granola' | 'fathom' | 'linear' | 'hubspot' | 'salesforce' | 'coda' | 'lightfield', required
- `resource_id` string, required

## Request body

- UpdateRequest
  - `text` union — Full text of the document. If provided, the document will be re-indexed.
    - string
    - unknown
  - `collection` union — The collection to move the document to — deprecated, set the collection using metadata instead.
    - string
    - unknown
  - `title` union — Title of the document.
    - string
    - unknown
  - `date` union — Date of the document for ranking and filtering.
    - string, date-time
    - unknown
  - `metadata` union — Custom metadata for filtering. Keys must be alphanumeric with underscores, max 64 chars. Values must be string, number, boolean, or null. Will be merged with existing metadata.
    - object
    - unknown

## Response `200`

Successful Response

- DocumentStatusResponse
  - `source` 'reddit' | 'notion' | 'slack' | 'google_calendar' | 'google_mail' | 'box' | 'dropbox' | 'github' | 'google_drive' | 'vault' | 'web_crawler' | 'trace' | 'microsoft_teams' | 'gmail_actions' | 'granola' | 'fathom' | 'linear' | 'hubspot' | 'salesforce' | 'coda' | 'lightfield', required
  - `resource_id` string, required
  - `status` 'pending' | 'processing' | 'completed' | 'failed' | 'pending_review' | 'skipped', required

## Other responses

- `422` — Validation Error

## Changes

- **2026-05-20** `912f94dd47ba` — 1 warning, 1 info
  - added the new `lightfield` enum value to the `source` response property for the response status `200`
  - added the new enum value `lightfield` to the `path` request parameter `source`
- **2026-05-20** `d7c846c2cd79` — 1 warning, 1 info
  - added the new `coda` enum value to the `source` response property for the response status `200`
  - added the new enum value `coda` to the `path` request parameter `source`
- **2026-05-18** `6eb290df2d3b` — 2 warning, 2 info
  - added the new `hubspot` enum value to the `source` response property for the response status `200`
  - added the new `salesforce` enum value to the `source` response property for the response status `200`
  - added the new enum value `hubspot` to the `path` request parameter `source`
  - added the new enum value `salesforce` to the `path` request parameter `source`
- **2026-05-05** `023174b0253c` — 3 warning, 3 info
  - added the new `fathom` enum value to the `source` response property for the response status `200`
  - added the new `granola` enum value to the `source` response property for the response status `200`
  - added the new `linear` enum value to the `source` response property for the response status `200`
  - added the new enum value `fathom` to the `path` request parameter `source`
  - …2 more
- **2026-04-18** `864ec17bc07a` — 1 info
  - added the new optional request property `date`

[Change history](https://skmtc.dev/hyperspell/apis/hyperspell-api/changes/memories/update/:source/:resource_id/post.md)

---

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