Memory API

Hubify uses a four-layer memory model to give agents persistent context across sessions:

Layer	Store	Contents
`messages`	`userMemory`	Captain—agent conversation history
`preferences`	`userMemory`	Captain’s persistent preferences and working style
`learnings`	`agentLearnings`	Facts and patterns agents have extracted from experiments
`decisions`	`labDecisions`	Lab-level policy decisions logged by the Captain

Get Memory

labId

string

required

Convex ID of the lab.

layer

string

default:"all"

Which layer to return: messages, preferences, learnings, decisions, or all.

# All layers
curl "https://www.hubify.com/api/v1/memory?labId=$LAB_ID" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

# Just learnings
curl "https://www.hubify.com/api/v1/memory?labId=$LAB_ID&layer=learnings" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

messages

object[]

Recent user—agent messages (up to 50, newest first). Only present when layer=messages or layer=all.

Show Message

role

string

One of user, assistant.

content

string

Message text.

sessionId

string

Chat session ID.

createdAt

number

Unix ms.

preferences

object[]

Captain preferences. Only present when layer=preferences or layer=all.

Show Preference

key

string

Preference key (e.g., default_model).

value

string

Preference value.

learnings

object[]

Agent-extracted facts and patterns. Only present when layer=learnings or layer=all.

Show Learning

content

string

Extracted fact or pattern.

agentId

string

Agent that extracted the learning.

experimentId

string

Source experiment, if any.

confidence

number

0-1 confidence score.

createdAt

number

Unix ms.

decisions

object[]

Lab policy decisions logged by the Captain. Only present when layer=decisions or layer=all.

Show Decision

title

string

Short decision title.

rationale

string

Why this decision was made.

createdAt

number

Unix ms.

Append Memory

labId

string

required

Convex lab ID.

layer

string

required

Target layer: messages, preferences, learnings, or decisions.

content

string

Message or learning content (for messages, learnings).

role

string

Message role (user or assistant) — required for messages layer.

key

string

Preference key — required for preferences layer.

value

string

Preference value — required for preferences layer.

title

string

Decision title — required for decisions layer.

rationale

string

Decision rationale — required for decisions layer.

# Log a decision
curl -X POST https://www.hubify.com/api/v1/memory \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "labId": "$LAB_ID",
    "layer": "decisions",
    "title": "Use H200 SXM for MCMC runs only",
    "rationale": "CPU is sufficient for Fisher matrix forecasts; reserve GPU for MCMC."
  }'

Overview

Labs

Data

Compute

Lab Ops

Memory

Memory API

Get Memory

Append Memory

​Memory API

​Get Memory

​Append Memory

Memory API

Get Memory

Append Memory