Memories

Manage your stored memories — list, retrieve, update, and delete.

List Memories

GET

/v1/memories

List all memories with optional filtering and pagination.

Query Parameters

Parameter	Type	Required	Description
`limit`	number	No	Max results (default: 20, max: 100)
`offset`	number	No	Pagination offset
`spaceId`	string	No	Filter by space
`tags`	string	No	Comma-separated tags
`after`	string	No	Filter by date (ISO 8601)
`before`	string	No	Filter by date (ISO 8601)

Examples

curl https://api.hypersave.io/v1/memories?limit=20 \
  -H "Authorization: Bearer YOUR_API_KEY"

With filters:

curl "https://api.hypersave.io/v1/memories?tags=important,work&after=2024-01-01&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "data": [
    {
      "id": "doc_abc123",
      "title": "Team Meeting Notes",
      "content": "Discussed Q1 roadmap and upcoming releases...",
      "tags": ["meetings", "planning"],
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    },
    {
      "id": "doc_xyz789",
      "title": "Product Ideas",
      "content": "New feature suggestions from customer feedback...",
      "tags": ["product", "ideas"],
      "createdAt": "2024-01-14T16:45:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 156,
    "hasMore": true
  }
}

Get Single Memory

GET

/v1/memory/:id

Retrieve a specific memory by its ID.

curl https://api.hypersave.io/v1/memory/doc_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "data": {
    "id": "doc_abc123",
    "title": "Team Meeting Notes",
    "content": "Full content of the memory...",
    "description": "Notes from weekly team sync",
    "tags": ["meetings", "planning"],
    "metadata": {
      "source": "manual",
      "author": "john@example.com"
    },
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:30:00Z"
  }
}

Delete Memory

DELETE

/v1/memory/:id

Permanently delete a memory.

⚠️

This action cannot be undone. The memory and all associated data will be permanently deleted.

curl -X DELETE https://api.hypersave.io/v1/memory/doc_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "message": "Memory deleted successfully"
}

Bulk Operations

Bulk Delete

Delete multiple memories at once:

curl -X POST https://api.hypersave.io/v1/memories/delete \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["doc_abc123", "doc_xyz789", "doc_def456"]
  }'

Response:

{
  "success": true,
  "deleted": 3,
  "failed": []
}

Error Responses

Memory Not Found

{
  "success": false,
  "error": "NOT_FOUND",
  "message": "Memory not found"
}

Invalid Memory ID

{
  "success": false,
  "error": "VALIDATION_ERROR",
  "message": "Invalid memory ID format"
}

Query Remind