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
Languages
Servers
Production server
https://memoryserver-staging-223473570766.us-west1.run.app/

v1

Operations

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": {} }

List Namespaces

Request

List namespaces for the developer's organization.

Query
skipinteger(Skip)>= 0

Number of items to skip

Default 0
limitinteger(Limit)[ 1 .. 100 ]

Max items to return

Default 20
Headers
X-API-Keystring(X-Api-Key)required
curl -i -X GET \
  'https://memoryserver-staging-223473570766.us-west1.run.app/v1/namespace?limit=20&skip=0' \
  -H 'X-API-Key: string'

Responses

Namespaces listed

Bodyapplication/json
codeinteger(Code)

HTTP status code

Default 200
statusstring(Status)

'success' or 'error'

Default "success"
dataArray of Data (objects) or Data (null)(Data)

List of namespaces

Any of:

List of namespaces

totalTotal (integer) or Total (null)(Total)

Total matching namespaces

Any of:

Total matching namespaces

integer(Total)

Total matching namespaces

pagePage (integer) or Page (null)(Page)

Current page (0-indexed skip)

Any of:

Current page (0-indexed skip)

integer(Page)

Current page (0-indexed skip)

page_sizePage Size (integer) or Page Size (null)(Page Size)

Items per page

Any of:

Items per page

integer(Page Size)

Items per page

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": [ {} ], "total": 0, "page": 0, "page_size": 0, "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