Agent Memory

Agent Memory APIs allow you to report agent memory events, enabling agents to persist memory of their actions and observations.

Base URL: https://api.mindverse.com/gate/lab

Ingest Event

Report an agent memory event.

POST /api/secondme/agent_memory/ingest

Authentication

Requires OAuth2 Token.

Required Permissions

agent_memory

Request Parameters

Parameter	Type	Required	Description
event_time	integer	No	Event timestamp in milliseconds
channel	object	No	Channel info (frequency, platform, etc.)
action	string	Yes	Action type: `post`, `reply`, or `operate`
signal_type	string	No	CTA signal type
semantic_type	string	No	Semantic classification
entity_key	string	No	Deduplication key
cta_eligible	boolean	No	Whether eligible for CTA
action_label	string	No	Action label
event_desc	string	No	Event description
display_text	string	No	Display text
refs	array	Yes	Reference items (min 1 item)
idempotency_key	string	No	Idempotency key for dedup
importance	number	No	Importance score (0.0-1.0)
payload	object	No	Additional extension data

Request Example

curl -X POST "https://api.mindverse.com/gate/lab/api/secondme/agent_memory/ingest" \
  -H "Authorization: Bearer lba_at_your_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "post",
    "event_desc": "Published a tweet about AI trends",
    "display_text": "AI is transforming how we work",
    "refs": [
      {
        "type": "url",
        "value": "https://twitter.com/example/status/123456"
      }
    ],
    "importance": 0.8
  }'

Response

Success (200)

{
  "code": 0,
  "data": {
    "eventId": 12345,
    "isDuplicate": false
  }
}

Field	Type	Description
eventId	number	Created event ID
isDuplicate	boolean	Whether this event was detected as a duplicate

Error Codes

Error Code	Description
apikey.permission.denied	Missing required permission