---
title: "Upload a file"
method: POST
path: "/memories/upload"
tags: ["Memories"]
---

# Upload a file

`POST /memories/upload`

This endpoint will upload a file to the index and return a resource_id.
The file will be processed in the background and the memory will be available for querying once the processing is complete.
You can use the `resource_id` to query the memory later, and check the status of the memory.

## 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
  - added the new `lightfield` enum value to the `source` response property for the response status `200`
- **2026-05-20** `d7c846c2cd79` — 1 warning
  - added the new `coda` enum value to the `source` response property for the response status `200`
- **2026-05-18** `6eb290df2d3b` — 2 warning
  - 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`
- **2026-05-05** `023174b0253c` — 3 warning
  - 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`

[Change history](https://skmtc.dev/hyperspell/apis/hyperspell-api/changes/memories/upload/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)