Copilot

Promote Copilot Memory

Promote what is worth keeping out of the daily journal into durable memory.

The garbage-collection step of the whole memory design. Without it the journal grows without bound and the durable documents stay empty, so the assistant ends up with a great deal of noise and very little knowledge.

post/copilot/memory/promote

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/copilot/memory/promote
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

subject_typestring required

organization | user | campaign | company | contact.

subject_idstring required

Which one.

days_backinteger

How far back through the daily journal to look for things worth keeping. Promotion is what stops the journal growing forever and the durable memory staying empty.

Response

Successful Response

dataCopilotMemoryPayload required

An open envelope for one memory, wiki or sharing answer.

Open because the personal wiki is a DOCUMENT whose sections follow what has been learned about a person, and because each fact carries provenance - which mailbox or meeting it came from - that grows as new sources are connected. Pinning the shape would silently drop the provenance on the newest source, and on a "what do you know about me" surface a fact with no visible origin is worse than no fact.

Changes

No recorded changes to this operation across all 2 revisions of this API.