Remember something

Before you call

Credential

Authorization: Bearer $KEY

Scope

memory:write

Mcp

rivier_personas_memory_put

Graphql

Mutation.memoryItemCreate

Sdk

memory.item.create

Cli

memory item create

Events

memory.item.created

Request bodyapplication/json, required

• scopeobjectrequired
  • levelstringrequired
    One of: account, organization, project, product, agent.
  • idstringrequired
    At most 120 characters.
• kindstringrequired
  One of: business_fact, brand_voice, guideline, product, policy, faq, decision, preference, conversation_summary, correction, note, research_note, reflection, opinion, life_event, relationship.
• textstringrequired
  At most 4000 characters.
• languagestring
  At most 20 characters.
• sourceobjectrequired
  • typestringrequired
    One of: upload, conversation, web, connector, human, reflection, lw, call.
  • refstring
    At most 300 characters.
  • labelstring
    At most 120 characters.
  • urlstring
    At most 500 characters.
  • retrievedAtstring
    At most 40 characters.
• originstringrequired
  One of: human, learned, research, reflection, persona_life, conversation.
• statestring
  One of: proposed, active.
• confidencenumber
  At least 0. At most 1.
• importancenumber
  At least 0. At most 1.
• sensitiveboolean
• pinnedboolean
• visibilitystring
  One of: all_agents, named_agents, humans_only.
• visibleTolist of string
• validFromstring
  At most 40 characters.
• validTostring or null
• entityIdslist of string (uuid)

Responses

• 201application/json
  Success
  • idstring (uuid)required
  • kindstringrequired
    One of: business_fact, brand_voice, guideline, product, policy, faq, decision, preference, conversation_summary, correction, note, research_note, reflection, opinion, life_event, relationship.
  • textstringrequired
  • statestringrequired
• 400application/json
  The request was malformed
  • errorstringrequired
  • messagestring
• 401application/json
  No valid credential
  • errorstringrequired
  • messagestring
• 403application/json
  The credential lacks the scope, origin or address
  • errorstringrequired
  • messagestring
• 429application/json
  Over the key's rate limit; see Retry-After
  • errorstringrequired
  • messagestring