FurniOpsDocs
API referenceAssistant

List your memories

The notes FurniOps AI reads at the start of every turn here, oldest first: yours in this organisation, then the organisation's, each with where it came from and when it expires.

  • Scopesnone
  • Rate classread
GET/v1/assistant/memories

The notes FurniOps AI reads at the start of every turn here, oldest first: yours in this organisation, then the organisation's, each with where it came from and when it expires.

Authorization

apiKey
AuthorizationBearer <token>

An API key (fo_live_… / fo_test_…) as a bearer token

In: header

Query Parameters

scope?string

Only this scope

Value in

  • "person"
  • "org"

Header Parameters

FurniOps-Version?string

Dated API version; pinned per organisation on first use and overridable per request

Value in

  • "2026-10-01"
  • "2026-10-04"
FurniOps-Mode?string

The data the request acts on: test is the organisation's sandbox. An OAuth token picks it (live by default); an API key's mode is fixed, and naming the other one is refused

Value in

  • "live"
  • "test"
If-None-Match?string

ETag of a cached representation; a match returns 304

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/assistant/memories"
{  "object": "list",  "data": [    {      "object": "assistant_memory",      "id": "string",      "scope": "person",      "content": "string",      "source": "person",      "created_by": "string",      "surface": "console",      "conversation_id": "string",      "tool_data_seen": true,      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "expires_at": "2019-08-24T14:15:22Z"    }  ],  "has_more": true,  "next_cursor": "string"}

List your conversations GET

Your conversations with FurniOps AI in this organisation and mode, latest first. Only your own: nobody else, admins included, reads them.

Update a memory PATCH

Rewrites a memory, or keeps it another 365 days (`renew`). An organisation's memory needs `assistant_memories:write`.