API Reference
/
v1
/
Export memories to OMO format

Papr Memory API (1.0.0)

API for managing personal memory items with authentication and user-specific data.

Authentication

This API supports three authentication methods:

  • API Key: Include your API key in the X-API-Key header
    X-API-Key: <your-api-key>
  • Session Token: Include your session token in the X-Session-Token header
    X-Session-Token: <your-session-token>
  • Bearer Token: Include your OAuth2 token from Auth0 in the Authorization header
    Authorization: Bearer <token>

All endpoints require one of these authentication methods.

Download OpenAPI description
index.json
index.yaml
Languages
Servers
Production server
https://memoryserver-staging-223473570766.us-west1.run.app/

v1

Operations

Process Session Messages

Request

Process all stored messages in a session that were previously stored with process_messages=false.

Authentication Required: Bearer token, API key, or session token

This endpoint allows you to retroactively process messages that were initially stored without processing. Useful for:

  • Processing messages after deciding you want them as memories
  • Batch processing large conversation sessions
  • Re-processing sessions with updated AI models

Processing Behavior:

  • Only processes messages with status 'stored_only' or 'pending'
  • Uses the same smart batch analysis (every 15 messages)
  • Respects existing memory creation pipeline
Path
session_idstring(Session Id)required
curl -i -X POST \
  'https://memoryserver-staging-223473570766.us-west1.run.app/v1/messages/sessions/{session_id}/process' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Session messages queued for processing

Bodyapplication/json
any
Response
application/json
null

Export memories to OMO format

Request

Export memories in Open Memory Object (OMO) standard format.

This enables memory portability to other OMO-compliant platforms. The exported format follows the OMO v1 schema.

OMO Standard: https://github.com/papr-ai/open-memory-object

Bodyapplication/jsonrequired
memory_idsArray of strings(Memory Ids)required

List of memory IDs to export

curl -i -X POST \
  https://memoryserver-staging-223473570766.us-west1.run.app/v1/omo/export \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "memory_ids": [
      "string"
    ]
  }'

Responses

Successful Response

Bodyapplication/json
codeinteger(Code)
Default 200
statusstring(Status)
Default "success"
countinteger(Count)required

Number of memories exported

memoriesArray of objects(Memories)required

Memories in OMO v1 format

memories[].​property name*anyadditional property
errorError (string) or Error (null)(Error)
Any of:
string(Error)
Response
application/json
{
  "code": 200,
  "status": "success",
  "count": 0,
  "memories": [
    {}
  ],
  "error": "string"
}

Import memories from OMO format

Request

Import memories from Open Memory Object (OMO) standard format.

This enables importing memories from other OMO-compliant platforms.

OMO Standard: https://github.com/papr-ai/open-memory-object

Bodyapplication/jsonrequired
memoriesArray of objects(Memories)required

List of memories in OMO v1 format

memories[].​property name*anyadditional property
skip_duplicatesboolean(Skip Duplicates)

Skip memories with IDs that already exist

Default true
curl -i -X POST \
  https://memoryserver-staging-223473570766.us-west1.run.app/v1/omo/import \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "memories": [
      {}
    ],
    "skip_duplicates": true
  }'

Responses

Successful Response

Bodyapplication/json
codeinteger(Code)
Default 200
statusstring(Status)
Default "success"
importedinteger(Imported)required

Number of memories successfully imported

skippedinteger(Skipped)

Number of memories skipped (duplicates)

Default 0
errorsArray of objects(Errors)

Import errors

memory_idsArray of strings(Memory Ids)

IDs of imported memories

Response
application/json
{
  "code": 200,
  "status": "success",
  "imported": 0,
  "skipped": 0,
  "errors": [
    {}
  ],
  "memory_ids": [
    "string"
  ]
}

Memory

Operations

Memory Status

Operations

User

Operations

Feedback

Operations

Schema Management

Operations

Messages

Operations

omo

Operations

Namespace

Operations

Frequency Schemas

Operations

Holographic Transform

Operations

Instance Configuration

Operations

AI Proxy

Operations

Sync

Operations

Telemetry

Operations

Document

Operations

GraphQL

Operations

Authentication

Operations