​
Basic Usage

To add a memory, send a POST request to /add with your content:

curl https://api.supermemory.ai/v3/memories \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "id": "acxV5LHMEsG2hMSNb4umbn",
  "userId": "user_123",
  "content": "This is the content of my memory",
  "metadata": {
    "category": "technology",
    "tag_1": "ai",
    "tag_2": "machine-learning",
  },
}'

The API will return a response with an ID and initial status:

{
  "id": "mem_abc123",
  "status": "queued"
}

​
Adding Web Content

To add content from a webpage, simply provide the URL:

curl https://api.supermemory.ai/v3/memories \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  -d '{
    "content": "https://example.com/article",
    "metadata": {
      "source": "web",			# Just example metadata
      "category": "technology"	# NOT required
    }
  }'

​
Metadata and Organization

You can add rich metadata to organize your content:

{
  "metadata": {
    "source": "string",      // String 
    "priority": 1234,   // Custom numeric field
    "custom_field": "any"   // Any custom field
  }
}

​
Partitioning by user

You can attribute and partition your data by providing a userId:

curl https://api.supermemory.ai/v3/memories \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  -d '{
    "content": "This is space-specific content",
    "userId": "space_123",
    "metadata": {
      "category": "space-content"
    }
  }'

When searching, if you provide a userId, only memories from that space will be returned.

​
Checking Status

Check status using the memory ID:

curl https://api.supermemory.ai/v3/memories/mem_abc123 \
  --request GET \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Memories are deleted after 2 minutes if an irrecoverable error occurs.

​
Next Steps

Explore more advanced features in our API Reference.