Skip to main content
This guide takes you from an API key to your first memory response.

Prerequisites

Before you begin, you need:
  • A Replay account
  • At least one memory in your account
  • An API key from your account settings in the Replay web app
  • The public API base URL for your environment
1

Get your API key

Open the Replay web app and go to your account settings. Create or copy an API key.Keep this key private. It can read memories from your account.
2

Set local environment variables

Store the API base URL and API key in environment variables.
export REPLAY_PUBLIC_API_URL="https://api.runreplay.com"
export REPLAY_API_KEY="rpa_..."
If your account settings show a different API endpoint, use that endpoint.
3

List your memories

Call GET /v1/memories.
curl --request GET \
  --url "$REPLAY_PUBLIC_API_URL/v1/memories" \
  --header "Authorization: Bearer $REPLAY_API_KEY"
The response is an array of memories owned by your account.
4

Fetch one memory

Copy a memory id from the list response and call GET /v1/memories/{memory_id}.
curl --request GET \
  --url "$REPLAY_PUBLIC_API_URL/v1/memories/mem_123" \
  --header "Authorization: Bearer $REPLAY_API_KEY"

Example response

{
  "id": "mem_123",
  "name": "Product planning walk",
  "started_at": "2026-06-01T16:02:11Z",
  "ended_at": "2026-06-01T16:18:42Z",
  "is_processing": false,
  "user_id": "user_123",
  "duration_seconds": 991,
  "summary": {
    "quick_summary": "A planning conversation about the public API launch.",
    "key_takeaways": [
      "Ship read-only access first.",
      "Expose memory list and detail endpoints."
    ]
  },
  "transcript": "We talked through the public API launch..."
}

Next steps