FurniOpsDocs
API referenceAssistant

Update a memory

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

  • Scopesnone
  • Rate classwrite
PATCH/v1/assistant/memories/{memory}

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

Authorization

apiKey
AuthorizationBearer <token>

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

In: header

Path Parameters

memory*string

Assistant memory (a note a person, or their organisation, saved for FurniOps AI) ID

Match^mem_[0-9A-Za-z]{22}$

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"
FurniOps-Dry-Run?string

Preview the write and change nothing: true answers the would-be response, explain a Preview (application/vnd.furniops.preview+json)

Value in

  • "true"
  • "explain"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

New words, or another year

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X PATCH "https://example.com/v1/assistant/memories/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "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"}

List your memories GET

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.

Update Ask AI for the organisation PATCH

Turns Ask AI on (naming the data-handling disclosure accepted in `accept_disclosure`) or off, and sets the roles allowed, the most autonomy, the daily budgets (a member's at most the organisation's plus its daily FurniOps AI credit limit) and the MCP and memory switches. Not in the plan answers 403 `feature_unavailable`. Recorded in the audit log (`assistant_settings.updated`).