agents

List memories

The agent's current memories, newest first, in pages. Filter by subject, user_id, run_id, kind or tag; expired ones are left out unless include_expired is true, and so are older versions of a memory (read those with …/memories/{id}/history). Without a user_id or a subject it lists every subject, the agent's users' memories included. The answer is { memories, next_cursor }: pass next_cursor back as cursor for the next page, and stop when it is null. The cursor is a time (ISO 8601, the created_at of the last memory on the page), so URL-encode it if you build the query by hand: a + in a time zone offset would otherwise be read as a space and refused. A paused agent can still be listed. Needs the agent's own key or a person's key with read.

get/v1/agents/{agent}/memories

Request

  • Base URL: https://innernet.live/api
  • URL: https://innernet.live/api/v1/agents/{agent}/memories
  • Auth: HTTP bearer

Path parameters

agentstring required

The agent's slug, its id, or me (the agent a key made for one agent is bound to). Another agent, by any name, is a 404 to an agent key.

Query parameters

subject'agent' | 'owner' | 'user'

Who the memories are about. With user_id it can only be user.

user_idstring

One of the agent's users: lists that user's memories.

run_idstring

Only the memories kept in this run.

kind'fact' | 'preference' | 'episode' | 'procedure' | 'instruction' | 'note'
tagstring

Only memories carrying this tag.

limitinteger
cursorstring date-time

The next_cursor of the page before. A time; URL-encode it.

include_expiredboolean

Also memories whose expires_at has passed and that the nightly purge has not yet removed.

Response

OK

next_cursorstring date-time nullable required

Pass it back as cursor for the next page. null on the last page.

Changes

No recorded changes to this operation across all 1 revision of this API.