API Documentation

Overview

The Recall API allows you to programmatically access a user's memories. This is useful for:

• Building AI agents that need user context
• Integrating memory into automation workflows
• Syncing context across multiple AI tools
• Building custom dashboards and interfaces

Authentication

All API requests require an API key. Generate one from the Recall extension settings.

Pass the key via query parameter or header:

GET/api/memories

Fetch a user's memories. Optionally filter by category.

Parameters

Response

{
  "memories": [
    {
      "content": "I'm a software developer",
      "category": "work",
      "created_at": "2026-02-06T12:00:00Z"
    }
  ],
  "count": 1,
  "plan": "free",
  "rateLimit": {
    "limit": 60,
    "remaining": 59,
    "reset": 60
  }
}

POST/api/memories

Generate a new API key. Maximum 3 keys per user.

Request Body

{
  "email": "user@example.com",
  "userId": "uuid-here",
  "name": "My Agent Key"
}

Response

{
  "apiKey": "rc_xxxxxxxxxxxxxxxx",
  "keyId": "uuid",
  "prefix": "rc_xxxxxxxx",
  "message": "Save this key - it won't be shown again!"
}

Rate Limits

Python Example

import requests

def get_user_context(api_key):
    """Fetch user memories from Recall API"""
    response = requests.get(
        "https://tryrecallapp.com/api/memories",
        params={"apiKey": api_key}
    )
    data = response.json()
    
    # Format for injection into prompts
    context = "User context:\n"
    for memory in data["memories"]:
        context += f"- [{memory['category']}] {memory['content']}\n"
    
    return context

# Use in your agent
api_key = "rc_xxxxx"
user_context = get_user_context(api_key)
prompt = f"{user_context}\n\nUser: {user_message}"

JavaScript Example

async function getUserContext(apiKey) {
  const response = await fetch(
    `https://tryrecallapp.com/api/memories?apiKey=${apiKey}`
  );
  const data = await response.json();
  
  // Format for injection
  let context = "User context:\n";
  for (const memory of data.memories) {
    context += `- [${memory.category}] ${memory.content}\n`;
  }
  
  return context;
}

// Use in your agent
const apiKey = "rc_xxxxx";
const userContext = await getUserContext(apiKey);
const prompt = `${userContext}\n\nUser: ${userMessage}`;

cURL Example

# Fetch memories
curl "https://tryrecallapp.com/api/memories?apiKey=rc_xxxxx"

# Filter by category
curl "https://tryrecallapp.com/api/memories?apiKey=rc_xxxxx&category=work"

# Using header
curl "https://tryrecallapp.com/api/memories" \
  -H "x-api-key: rc_xxxxx"

Need help?

Questions about the API? Email us at hello@tryrecallapp.com