API Reference
/
v1
/
Export memories as .omo.json file

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

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"
  ]
}

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 \
  'https://memoryserver-staging-223473570766.us-west1.run.app/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

Create Namespace

Request

Create a new namespace within the developer's organization.

Headers
X-API-Keystring(X-Api-Key)required
Bodyapplication/jsonrequired
namestring(Name)[ 1 .. 128 ] charactersrequired

Namespace name (e.g., 'acme-production')

Example: "acme-production"
environment_typestring(EnvironmentType)

Environment type: development, staging, production

Default "production"
Enum"development""staging""production"
Example: "production"
is_activeboolean(Is Active)

Whether this namespace is active

Default true
Example: true
rate_limitsRate Limits (object) or Rate Limits (null)(Rate Limits)

Rate limits for this namespace (None values inherit from organization)

Example: {}
Any of:

Rate limits for this namespace (None values inherit from organization)

curl -i -X POST \
  https://memoryserver-staging-223473570766.us-west1.run.app/v1/namespace \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: string' \
  -d '{
    "environment_type": "production",
    "is_active": true,
    "name": "acme-production",
    "rate_limits": {}
  }'

Responses

Namespace created

Bodyapplication/json
codeinteger(Code)

HTTP status code

Default 200
statusstring(Status)

'success' or 'error'

Default "success"
dataNamespaceItem (object) or null

Namespace data if successful

Any of:

Namespace data if successful

errorError (string) or Error (null)(Error)

Error message if failed

Any of:

Error message if failed

string(Error)

Error message if failed

detailsDetails (any) or Details (null)(Details)

Additional error details or context

Any of:

Additional error details or context

any(Details)

Additional error details or context

Response
application/json
{
  "code": 200,
  "status": "success",
  "data": {
    "objectId": "string",
    "name": "string",
    "environment_type": "string",
    "is_active": true,
    "rate_limits": { … },
    "organization_id": "string",
    "instance_config": { … },
    "storageCount": 0,
    "memoriesCount": 0,
    "createdAt": "string",
    "updatedAt": "string"
  },
  "error": "string",
  "details": {}
}

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