Open items · Alexein Docs

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

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

Lists the issues and pull requests from connected apps that are still open, newest first: by default the person's own, what they wrote, are assigned or review. Beside them, follow_ups lists the asks nobody has answered. Use it for "what is still on my plate". An item stays open until its app reports it closed or gone. The MCP tool memory_open_items answers the same.

Headers

Authorizationstringrequired

Bearer tm_…. A read key is enough.

X-Alexein-Userstringrequired

The app user whose memory to read. See App users.

X-Request-Idstring

Your id for this request, echoed on the response.

Body

kindstring[]

issue, pull_request, or both. Default both. One kind as a plain string is taken too.

providerstring

Only one connected app, such as github or linear.

placestring

Only one place in it, such as a repository.

mineboolean

Only what the person wrote, is assigned or reviews. Default true; false for everyone's.

within_daysinteger

Only what happened in this many days. 0 to 3,650; default 0, any age.

limitinteger

How many of each list, 1 to 50. Default 20.

Response

itemsobject[]

Newest first, each {ref, text, date, added_at, age_days}: ref is what open and around take, text a line saying where it came from, its link and its state, then its title, date when it happened, added_at when memory took it, and age_days how many days ago it happened.

follow_upsobject[]

Asks nobody answered, each {title, who, date, age_days}: what was asked, by or of whom, and when. Any field can be null.

Errors

400bad request

X-Alexein-User is missing or not a usable id.

401unauthorized

The bearer is not a key this service issued.

403forbidden

The organisation has been closed in the console.

404not found

no memory for app user 'user_42' yet.

422invalid

A limit outside 1 to 50, a within_days outside 0 to 3,650, or more than 8 kinds.

429too many requests

Too many requests in flight, or reads too fast. 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/open_items \
  -H "Authorization: Bearer $ALEXEIN_API_KEY" \
  -H "X-Alexein-User: user_42" \
  -H "Content-Type: application/json" \
  -d '{ "kind": ["pull_request"], "within_days": 30 }'

200 OK

{
  "items": [
    {
      "ref": "mem_8tN3wP6rYc1",
      "text": "[github · items · pull_request] https://github.com/acme/web/pull/412 · repo=acme/web number=412 state=open\nCache the pricing page per region",
      "date": "2026-10-01T15:04:00+00:00",
      "added_at": "2026-10-01T15:06:12+00:00",
      "age_days": 2
    }
  ],
  "follow_ups": [
    {
      "title": "Send Bruno the Q3 numbers",
      "who": "Bruno",
      "date": "2026-09-29T10:00:00+00:00",
      "age_days": 4
    }
  ]
}