Looki Memory

Looki Memory

Looki gives you a digital memory captured by the Looki L1 wearable, which sees and hears moments throughout your day. This skill lets AI assistants access your real-world context — the places you went, the people you met, and the things you did — so they can help in ways that go beyond what's on your screen. Use it when you want more personalized, context-aware, data-driven responses.

Base URL: Read from ~/.config/looki/credentials.json → base_url field. If the file does not exist, ask the user for both base_url and api_key.

Security:

• Before first use, validate the base_url by sending a GET request to https://open.looki.ai/api/v1/verify?endpoint={base_url}. Do not include the API key in this request. If validation fails, inform the user and do not proceed.
• Only send the API key in the X-API-Key header to {base_url}/* endpoints. Do not send it to any other domain.
• Do not save the API key to agent memory, chat history, or any location other than ~/.config/looki/credentials.json.

Setup

Credentials file: ~/.config/looki/credentials.json

On first use, check if this file exists. If it does, read base_url and api_key from it. If it does not, ask the user for both values and offer to save them to this file.

{
    "base_url": "",
    "api_key": ""
}

• base_url — The API endpoint URL provided by the user. Do not assume a default; always ask the user if not already saved.
• api_key — The user's Looki API key, starting with lk-.

Credentials should only be stored in this file. Do not save the API key to agent memory, environment variables, or any other persistent storage.

---

Authentication

All requests require your API key in the X-API-Key header:

curl "{base_url}/me" \
  -H "X-API-Key: YOUR_API_KEY"

---

Rate Limiting

API requests are limited to 60 requests per minute per API key. If you exceed this limit, the API will respond with HTTP 429:

HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "code": 429,
  "detail": "Rate limit exceeded. Please retry after 60 seconds."
}

---

File Downloads

File download URLs may appear in any response containing a FileModel. Make up to 3 total download attempts, waiting 1 second between attempts.

---

Data Models

MomentModel

MomentFileModel

FileModel

JournalModel

JournalMediaItemModel

ForYouItemModel

---

About Me

Who am I

Returns your basic profile — name, email, timezone, and other details tied to your Looki account.

curl "{base_url}/me" \
  -H "X-API-Key: YOUR_API_KEY"

Response:

{
    "code": 0,
    "detail": "success",
    "data": {
        "user": {
            "id": "string",
            "email": "string",
            "first_name": "string",
            "last_name": "string",
            "tz": "string",
            "gender": "string",
            "birthday": "string",
            "region": "string"
        }
    }
}

My Memories

What happened these days

Returns a calendar view of moments for a date range, showing which days have recorded moments and a highlight description from each day.

curl "{base_url}/moments/calendar?start_date=2026-01-01&end_date=2026-01-31" \
  -H "X-API-Key: YOUR_API_KEY"

Response:

{
    "code": 0,
    "detail": "success",
    "data": [
        {
            "date": "2026-01-15",
            "highlight_moment": {
                "id": "string",
                "title": "string",
                "description": "string",
                "media_types": ["IMAGE", "VIDEO"],
                "date": "2026-01-15",
                "tz": "+08:00",
                "start_time": "2026-01-15T10:00:00+08:00",
                "end_time": "2026-01-15T12:00:00+08:00"
            }
        }
    ]
}

What happened on [date]

Returns everything that was captured on a specific day — each moment with its title, description, time range, and cover image.

curl "{base_url}/moments?on_date=2026-01-01" \
  -H "X-API-Key: YOUR_API_KEY"

Response:

{
    "code": 0,
    "detail": "success",
    "data": [
        {
            "id": "string",
            "title": "string",
            "description": "string",
            "media_types": ["IMAGE", "VIDEO"],
            "cover_file": {
                "id": "string",
                "file": {
                    "temporary_url": "string",
                    "media_type": "IMAGE",
                    "size": 1024,
                    "duration_ms": null
                },
                "thumbnail": null,
                "location": "string",
                "created_at": "2026-01-01T10:30:00+08:00",
                "tz": "+08:00"
            },
            "date": "2026-01-01",
            "tz": "+08:00",
            "start_time": "2026-01-01T10:00:00+08:00",
            "end_time": "2026-01-01T12:00:00+08:00"
        }
    ]
}

Recall this moment

Returns the full details of a single moment — its description, location, time range, and cover image.

curl "{base_url}/moments/MOMENT_ID" \
  -H "X-API-Key: YOUR_API_KEY"

Response:

{
    "code": 0,
    "detail": "success",
    "data": {
        "id": "string",
        "title": "string",
        "description": "string",
        "media_types": ["IMAGE", "VIDEO"],
        "cover_file": {
            "id": "string",
            "file": {
                "temporary_url": "string",
                "media_type": "IMAGE",
                "size": 1024,
                "duration_ms": null
            },
            "thumbnail": null,
            "location": "string",
            "created_at": "2026-01-15T10:30:00+08:00",
            "tz": "+08:00"
        },
        "date": "2026-01-15",
        "tz": "+08:00",
        "start_time": "2026-01-15T10:00:00+08:00",
        "end_time": "2026-01-15T12:00:00+08:00"
    }
}

Photos and videos from this moment

Returns the photos and videos from a specific moment. You can filter to just the highlights or page through all media.

curl "{base_url}/moments/MOMENT_ID/files?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

Response:

{
    "code": 0,
    "detail": "success",
    "data": {
        "items": [
            {
                "id": "string",
                "file": {
                    "temporary_url": "string",
                    "media_type": "IMAGE",
                    "size": 1024,
                    "duration_ms": null
                },
                "thumbnail": {
                    "temporary_url": "string",
                    "media_type": "IMAGE",
                    "size": 512,
                    "duration_ms": null
                },
                "location": "string",
                "created_at": "2026-01-15T10:30:00+08:00",
                "tz": "+08:00"
            }
        ],
        "next_cursor_id": "string | null",
        "has_more": true
    }
}

Find moments about [topic]

Searches across all your memories using natural language. Returns moments ranked by relevance — useful when you remember the gist but not the exact date.

curl "{base_url}/moments/search?query=Something&page_size=10" \
  -H "X-API-Key: YOUR_API_KEY"

Response:

{
    "code": 0,
    "detail": "success",
    "data": {
        "items": [
            {
                "id": "string",
                "title": "string",
                "description": "string",
                "media_types": ["IMAGE"],
                "cover_file": { ... },
                "date": "2026-01-15",
                "tz": "+08:00",
                "start_time": "2026-01-15T10:00:00+08:00",
                "end_time": "2026-01-15T12:00:00+08:00"
            }
        ],
        "next_cursor_id": null,
        "has_more": true
    }
}

What did I write in my journal recently

Returns journal entries grouped by date. Use this when the user asks for their diary, journal, written recaps, or generated journal entries.

curl "{base_url}/journals?max_days=7" \
  -H "X-API-Key: YOUR_API_KEY"

The data.items array is dynamic and may contain one or more date groups. Each group's journals array is also dynamic and may contain one or more journal entries.

Response:

{
    "code": 0,
    "detail": "success",
    "data": {
        "items": [
            {
                "date": "2026-06-02",
                "start_date": null,
                "journals": [
                    {
                        "id": "string",
                        "type": "DIARY",
                        "title": "A day",
                        "description": "A journal entry",
                        "content": "A journal entry",
                        "media_items": [],
                        "date": "2026-06-02",
                        "start_date": null,
                        "tz": "+08:00",
                        "recorded_at": "2026-06-02T13:00:00+08:00",
                        "created_at": "2026-06-02T13:05:00+08:00"
                    }
                ]
            }
        ],
        "next_cursor_id": "2026-06-02",
        "has_more": true
    }
}

Did I journal on these days

Returns dates that have journal entries within a date range.

curl "{base_url}/journals/calendar?start_date=2026-06-01&end_date=2026-06-30" \
  -H "X-API-Key: YOUR_API_KEY"

The data array is dynamic and may contain one or more matching journal dates.

Response:

{
    "code": 0,
    "detail": "success",
    "data": [
        {
            "date": "2026-06-02"
        }
    ]
}

What did I journal on [date]

Returns all journal entries for a specific date.

curl "{base_url}/journals/by_date?on_date=2026-06-02" \
  -H "X-API-Key: YOUR_API_KEY"

The data array is dynamic and may contain one or more date groups. Each group's journals array is also dynamic and may contain one or more journal entries.

Response:

{
    "code": 0,
    "detail": "success",
    "data": [
        {
            "date": "2026-06-02",
            "start_date": null,
            "journals": [
                {
                    "id": "string",
                    "type": "DIARY",
                    "title": "A day",
                    "description": "A journal entry",
                    "content": "A journal entry",
                    "media_items": [],
                    "date": "2026-06-02",
                    "start_date": null,
                    "tz": "+08:00",
                    "recorded_at": "2026-06-02T13:00:00+08:00",
                    "created_at": "2026-06-02T13:05:00+08:00"
                }
            ]
        }
    ]
}

Open this journal entry

Returns full details of a single journal entry.

curl "{base_url}/journals/JOURNAL_ID" \
  -H "X-API-Key: YOUR_API_KEY"

Response:

{
    "code": 0,
    "detail": "success",
    "data": {
        "id": "string",
        "type": "DIARY",
        "title": "A day",
        "description": "A journal entry",
        "content": "A journal entry",
        "media_items": [],
        "date": "2026-06-02",
        "start_date": null,
        "tz": "+08:00",
        "recorded_at": "2026-06-02T13:00:00+08:00",
        "created_at": "2026-06-02T13:05:00+08:00"
    }
}

My Highlights

What's new for me

Returns AI-generated highlights made from your memories — vlogs and other creative recaps of your real-life experiences.

curl "{base_url}/for_you/items?limit=20&group=vlog" \
  -H "X-API-Key: YOUR_API_KEY"

Response:

{
    "code": 0,
    "detail": "success",
    "data": {
        "items": [
            {
                "id": "string",
                "type": "DAILY_VLOG",
                "title": "string",
                "description": "string",
                "content": "string",
                "cover": {
                    "temporary_url": "string",
                    "media_type": "IMAGE",
                    "size": null,
                    "duration_ms": null
                },
                "file": {
                    "temporary_url": "string",
                    "media_type": "IMAGE",
                    "size": null,
                    "duration_ms": null
                },
                "created_at": "2026-01-15T10:30:00+08:00",
                "recorded_at": "2026-01-14T18:00:00+08:00"
            }
        ],
        "next_cursor_id": "string | null",
        "has_more": true
    }
}

Realtime

What's happening right now

Returns the most recent realtime event detected by your Looki device. Requires proactive mode to be enabled in the Looki app.

Beta: This feature is currently in beta testing. You may not have access to enable proactive mode yet.

curl "{base_url}/realtime/latest-event" \
  -H "X-API-Key: YOUR_API_KEY"

Response:

{
    "code": 0,
    "detail": "success",
    "data": {
        "id": "string",
        "description": "string",
        "start_time": "2026-01-15T10:00:00+08:00",
        "end_time": "2026-01-15T10:15:00+08:00",
        "tz": "+08:00",
        "location": "string"
    }
}