Memories

What the assistant remembers about the calling user. Personal, never workspace-wide.

List memories

GET

https://api.genuineai.app/api/v1

/memories

What the assistant has remembered about the calling user — facts it carries into later conversations. Nobody else's are visible, including to an administrator.

List memories › query Parameters

cursor

string · maxLength: 512 · pattern: ^[A-Za-z0-9_-]+$

limit

integer

mem_active

boolean

mem_type

string · enum

Enum values:

fact

preference

context

mem_value

string

offset

integer · min: 0

sort

string · minLength: 1 · maxLength: 64 · pattern: ^-?[a-z0-9_]+$

List memories › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

List memories › Responses

Success

Memory[] · required

has_more

boolean · required

Whether more rows exist past this page.

next_cursor

string | null · required

Pass back as cursor for the next page. Null on the last page.

Add a memory

POST

https://api.genuineai.app/api/v1

/memories

Records something to remember about the calling user. Memories are personal — nobody else in the workspace sees them.

Add a memory › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Add a memory › Request Body

mem_value

string · minLength: 1 · maxLength: 1000 · required

mem_type

string · enum

Enum values:

fact

preference

context

Add a memory › Responses

Created

Something the assistant remembers about the calling user.

Memory

mem_id

string · uuid

mem_value

string

mem_type

string

mem_source

string

mem_thread

string

mem_active

boolean

mem_metadata

object

mem_created

string · date-time

mem_updated

string · date-time

Delete all memories

DELETE

https://api.genuineai.app/api/v1

/memories

Deletes every memory belonging to the caller and returns how many went. Not reversible.

Delete all memories › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Delete all memories › Responses

Success

No data returned

Delete a memory

DELETE

https://api.genuineai.app/api/v1

/memories/{id}

Forgets one memory. To clear them all at once, delete the collection.

Delete a memory › path Parameters

id

string · uuid · required

Delete a memory › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Delete a memory › Responses

Success. No content.

No data returned

Update a memory

PATCH

https://api.genuineai.app/api/v1

/memories/{id}

Rewrites one memory. Only the caller's own memories can be reached.

Update a memory › path Parameters

id

string · uuid · required

Update a memory › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Update a memory › Request Body optional

mem_value

string · minLength: 1 · maxLength: 1000

mem_type

string · enum

Enum values:

fact

preference

context

mem_active

boolean

Update a memory › Responses

Success

Something the assistant remembers about the calling user.

Memory

mem_id

string · uuid

mem_value

string

mem_type

string

mem_source

string

mem_thread

string

mem_active

boolean

mem_metadata

object

mem_created

string · date-time

mem_updated

string · date-time

PATCH/memories/{id}

curl https://api.genuineai.app/api/v1/memories/:id \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'X-Tenant-Id: <string>' \
  --header 'X-Api-Key: <api-key>' \
  --data '{
  "mem_value": "mem_value",
  "mem_type": "fact",
  "mem_active": true
}'

Example Request Body

{
  "mem_value": "mem_value",
  "mem_type": "fact",
  "mem_active": true
}

json

Example Responses

{
  "mem_id": "00000000-0000-0000-0000-000000000000",
  "mem_value": "mem_value",
  "mem_type": "mem_type",
  "mem_source": "mem_source",
  "mem_thread": "mem_thread",
  "mem_active": true,
  "mem_metadata": {},
  "mem_created": "2024-08-25T15:00:00Z",
  "mem_updated": "2024-08-25T15:00:00Z"
}

json

application/json

Wildcards Assist

List memories

GET

https://api.genuineai.app/api/v1

/memories

What the assistant has remembered about the calling user — facts it carries into later conversations. Nobody else's are visible, including to an administrator.

List memories › query Parameters

cursor

string · maxLength: 512 · pattern: ^[A-Za-z0-9_-]+$

limit

integer

mem_active

boolean

mem_type

string · enum

Enum values:

fact

preference

context

mem_value

string

offset

integer · min: 0

sort

string · minLength: 1 · maxLength: 64 · pattern: ^-?[a-z0-9_]+$

List memories › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

List memories › Responses

Success

Memory[] · required

has_more

boolean · required

Whether more rows exist past this page.

next_cursor

string | null · required

Pass back as cursor for the next page. Null on the last page.

Add a memory

POST

https://api.genuineai.app/api/v1

/memories

Records something to remember about the calling user. Memories are personal — nobody else in the workspace sees them.

Add a memory › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Add a memory › Request Body

mem_value

string · minLength: 1 · maxLength: 1000 · required

mem_type

string · enum

Enum values:

fact

preference

context

Add a memory › Responses

Created

Something the assistant remembers about the calling user.

Memory

mem_id

string · uuid

mem_value

string

mem_type

string

mem_source

string

mem_thread

string

mem_active

boolean

mem_metadata

object

mem_created

string · date-time

mem_updated

string · date-time

Delete all memories

DELETE

https://api.genuineai.app/api/v1

/memories

Deletes every memory belonging to the caller and returns how many went. Not reversible.

Delete all memories › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Delete all memories › Responses

Success

No data returned

Delete a memory

DELETE

https://api.genuineai.app/api/v1

/memories/{id}

Forgets one memory. To clear them all at once, delete the collection.

Delete a memory › path Parameters

id

string · uuid · required

Delete a memory › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Delete a memory › Responses

Success. No content.

No data returned

Update a memory

PATCH

https://api.genuineai.app/api/v1

/memories/{id}

Rewrites one memory. Only the caller's own memories can be reached.

Update a memory › path Parameters

id

string · uuid · required

Update a memory › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Update a memory › Request Body optional

mem_value

string · minLength: 1 · maxLength: 1000

mem_type

string · enum

Enum values:

fact

preference

context

mem_active

boolean

Update a memory › Responses

Success

Something the assistant remembers about the calling user.

Memory

mem_id

string · uuid

mem_value

string

mem_type

string

mem_source

string

mem_thread

string

mem_active

boolean

mem_metadata

object

mem_created

string · date-time

mem_updated

string · date-time