Skip to main content

​
Temporal Queries

Query memories from specific time periods.

​
Recall As Of

Endpoint: 
GET /api/v2/agents/{agent_id}/recall/as-of
Headers: 
Authorization: Bearer mk_api_key
X-Session-Token: {session_token}
Query Parameters:
  • query (string) - Search query
  • as_of (string) - ISO 8601 timestamp (e.g., “2025-03-28T14:00:00Z”)
  • limit (int) - Max results (default: 5)
Returns memories as they existed at the specified time. Example: 
# Get state as of yesterday
response = httpx.get(
    "http://localhost:8000/api/v2/agents/my-agent/recall/as-of",
    params={
        "query": "user status",
        "as_of": "2025-03-29T12:00:00Z"
    },
    headers={
        "Authorization": f"Bearer {api_key}",
        "X-Session-Token": token
    }
)

​
Recall Changed Since

Endpoint: 
GET /api/v2/agents/{agent_id}/recall/changed-since
Headers: 
Authorization: Bearer mk_api_key
X-Session-Token: {session_token}
Query Parameters:
  • query (string) - Search query
  • changed_since (string) - Date (e.g., “2025-03-28”)
  • limit (int) - Max results (default: 5)
Returns memories created or modified since the date. Example: 
# Get memories changed in last 7 days
response = httpx.get(
    "http://localhost:8000/api/v2/agents/my-agent/recall/changed-since",
    params={
        "query": "updates",
        "changed_since": "2025-03-23"
    },
    headers={
        "Authorization": f"Bearer {api_key}",
        "X-Session-Token": token
    }
)

​
Recall Current Only

Endpoint: 
GET /api/v2/agents/{agent_id}/recall/current
Headers: 
Authorization: Bearer mk_api_key
X-Session-Token: {session_token}
Query Parameters:
  • query (string) - Search query
  • limit (int) - Max results (default: 5)
Returns only current (non-superseded) memories. Example: 
response = httpx.get(
    "http://localhost:8000/api/v2/agents/my-agent/recall/current",
    params={"query": "commitments"},
    headers={
        "Authorization": f"Bearer {api_key}",
        "X-Session-Token": token
    }
)

​
Use Cases

​
Audit Trail

See what was known at a specific time: 
# What did we know about this customer on March 20?
response = httpx.get(
    f"{base}/agents/support/recall/as-of",
    params={
        "query": "customer status",
        "as_of": "2025-03-20T00:00:00Z"
    },
    headers=headers
)

​
Recent Changes

Get only recent updates: 
# What changed in the last 3 days?
response = httpx.get(
    f"{base}/agents/support/recall/changed-since",
    params={
        "query": "all updates",
        "changed_since": "2025-03-27"
    },
    headers=headers
)

​
Active Commitments

Get only current commitments: 
# What commitments are still active?
response = httpx.get(
    f"{base}/agents/support/recall/current",
    params={"query": "commitments"},
    headers=headers
)

​
Next Steps