Users · Alexein Docs

POST/v2/memory/usersReads memoryTry it in the Playground

Auth: read key
Cost: free; never refused for your plan

Lists the app users of the project your key belongs to: every id that has had something added. Use it to check your app users against your own list, or to find one to export or erase. The console's App users page shows the same list.

It is about the whole project, so it takes no X-Alexein-User. An app user appears once something has been added for them, and goes when they are deleted.

Headers

Authorizationstringrequired

Bearer tm_…. A read key is enough.

X-Request-Idstring

Your id for this request, echoed on the response.

Body

cursorstring

The next the previous page answered with, for the page after it. Leave it out for the first page.

limitinteger

How many app users on one page.

Response

usersobject[]

One entry per app user: user, the id you send as X-Alexein-User; items, how many items were added for them; facts, how many facts memory holds for them; and last_write, when something was last added.

nextstring | null

The cursor of the next page. null on the last page.

Errors

401unauthorized

The bearer is not a key this service issued.

403forbidden

The organisation has been closed in the console.

422invalid

A limit out of bounds. A cursor is the last app user's id of the page before: any id is taken, and the page starts after it.

429too many requests

Too many requests in flight. Retry after Retry-After seconds. See Limits.

503unavailable

The service is busy or briefly unavailable. Retry after Retry-After seconds, or with backoff when there is none.

Request

curl https://api.alexein.ai/v2/memory/users \
  -H "Authorization: Bearer $ALEXEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

200 OK

{
  "users": [
    { "user": "user_42", "items": 18, "facts": 41, "last_write": "2026-10-01T09:14:02Z" },
    { "user": "user_7", "items": 3, "facts": 5, "last_write": "2026-09-28T17:40:11Z" }
  ],
  "next": null
}