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

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

Get Namespace

Request

Retrieve a single namespace by ID.

Path
namespace_idstring(Namespace Id)required
Headers
X-API-Keystring(X-Api-Key)required
curl -i -X GET \
  'https://memoryserver-staging-223473570766.us-west1.run.app/v1/namespace/{namespace_id}' \
  -H 'X-API-Key: string'

Responses

Namespace retrieved

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

Update Namespace

Request

Update an existing namespace.

Path
namespace_idstring(Namespace Id)required
Headers
X-API-Keystring(X-Api-Key)required
Bodyapplication/jsonrequired
nameName (string) or Name (null)(Name)

Updated namespace name

Example: "acme-staging"
Any of:

Updated namespace name

[ 1 .. 128 ] characters
string(Name)[ 1 .. 128 ] characters

Updated namespace name

environment_typeEnvironmentType (string) or null

Updated environment type

Example: "staging"
Any of:

Updated environment type

string(EnvironmentType)

Updated environment type

Enum"development""staging""production"
is_activeIs Active (boolean) or Is Active (null)(Is Active)

Whether this namespace is active

Example: true
Any of:

Whether this namespace is active

boolean(Is Active)

Whether this namespace is active

rate_limitsRate Limits (object) or Rate Limits (null)(Rate Limits)

Updated rate limits (None values inherit from organization)

Any of:

Updated rate limits (None values inherit from organization)

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

Responses

Namespace updated

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