agent-memories

Create Memory Internal

Internal-key write path.

Server-side writers POST here with X-Internal-Key + X-Internal-User-Id. The route trusts the payload's agent_id but validates that the agent exists and that the resolved user can access it.

post/api/internal/memories

Request

  • Base URL: https://api.tintin-x.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.tintin-x.com/api/internal/memories
  • Auth: HTTP bearer

Request body

agent_idstring uuid required
user_idstring uuid nullable
textstring required
kind'preference' | 'fact' | 'instruction' | 'observation' | 'skill_outcome'
source'chat_user_explicit' | 'chat_inferred' | 'heartbeat' | 'admin' | 'skill' | 'memory_md' | 'memory_dir'
source_message_idstring uuid nullable
confidencenumber
pinnedboolean

Response

Successful Response

idstring uuid required
agent_idstring uuid required
user_idstring uuid nullable required
textstring required
kind'preference' | 'fact' | 'instruction' | 'observation' | 'skill_outcome' required
source'chat_user_explicit' | 'chat_inferred' | 'heartbeat' | 'admin' | 'skill' | 'memory_md' | 'memory_dir' required
source_message_idstring uuid nullable required
confidencenumber required
pinnedboolean required
hit_countinteger required
last_recalled_atstring date-time nullable required
expires_atstring date-time nullable required
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.