API Reference
/
omo
/
Import memories from 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
http://memory.papr.ai/

v1

Operations

Memory

Operations

User

Operations

Feedback

Operations

Schema Management

Operations

Messages

Operations

omo

Operations

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 \
  http://memory.papr.ai/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 \
  http://memory.papr.ai/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"
  ]
}

Export memories as .omo.json file

Request

Export memories in OMO JSON file format for download.

Query
memory_idsstring(Memory Ids)required

Comma-separated list of memory IDs

curl -i -X GET \
  'http://memory.papr.ai/v1/omo/export.json?memory_ids=string' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Successful Response

Bodyapplication/json
any
Response
application/json
null

Sync

Operations

Telemetry

Operations

Document

Operations

GraphQL

Operations

Authentication

Operations