API Reference
/
v1
/
Create User Schema V1

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

Get Feedback By Id V1

Request

Retrieve feedback by ID.

This endpoint allows developers to fetch feedback details by feedback ID. Only the user who created the feedback or users with appropriate permissions can access it.

Authentication Required: One of the following authentication methods must be used:

  • Bearer token in Authorization header
  • API Key in X-API-Key header
  • Session token in X-Session-Token header

Required Headers:

  • X-Client-Type: (e.g., 'papr_plugin', 'browser_extension')
Path
feedback_idstring(Feedback Id)required
curl -i -X GET \
  'http://memory.papr.ai/v1/feedback/{feedback_id}' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Feedback retrieved successfully

Bodyapplication/json
codeinteger(Code)required

HTTP status code

statusstring(Status)required

'success' or 'error'

feedback_idFeedback Id (string) or Feedback Id (null)(Feedback Id)

Unique feedback ID

Any of:

Unique feedback ID

string(Feedback Id)

Unique feedback ID

messagestring(Message)required

Human-readable message

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

Error message if status is 'error'

Any of:

Error message if status is 'error'

string(Error)

Error message if status is 'error'

detailsDetails (object) or Details (null)(Details)

Additional error details

Any of:

Additional error details

Response
application/json
{
  "code": 200,
  "status": "success",
  "feedback_id": "fb_123456789",
  "message": "Feedback retrieved successfully",
  "details": {
    "feedback_type": "thumbs_up",
    "feedback_score": 1,
    "feedback_text": "This was helpful!",
    "search_id": "search_123",
    "created_at": "2024-01-17T17:30:45.123456Z"
  }
}

Create User Schema V1

Request

Create a new user-defined graph schema.

This endpoint allows users to define custom node types and relationships for their knowledge graph. The schema will be validated and stored for use in future memory extractions.

Features:

  • Define custom node types with properties and validation rules
  • Define custom relationship types with constraints
  • Automatic validation against system schemas
  • Support for different scopes (personal, workspace, namespace, organization)
  • Status control: Set status to "active" to immediately activate the schema, or "draft" to save as draft (default)
  • Enum support: Use enum_values to restrict property values to a predefined list (max 15 values)
  • Auto-indexing: Required properties are automatically indexed in Neo4j when schema becomes active

Schema Limits (optimized for LLM performance):

  • Maximum 10 node types per schema
  • Maximum 20 relationship types per schema
  • Maximum 10 properties per node type
  • Maximum 15 enum values per property

Property Types & Validation:

  • string: Text values with optional enum_values, min_length, max_length, pattern
  • integer: Whole numbers with optional min_value, max_value
  • float: Decimal numbers with optional min_value, max_value
  • boolean: True/false values
  • datetime: ISO 8601 timestamp strings
  • array: Lists of values
  • object: Complex nested objects

Enum Values:

  • Add enum_values to any string property to restrict values to a predefined list
  • Maximum 15 enum values allowed per property
  • Use with default to set a default enum value
  • Example: "enum_values": ["small", "medium", "large"]

When to Use Enums:

  • Limited, well-defined options (≤15 values): sizes, statuses, categories, priorities
  • Controlled vocabularies: "active/inactive", "high/medium/low", "bronze/silver/gold"
  • When you want exact matching and no variations

When to Avoid Enums:

  • Open-ended text fields: names, titles, descriptions, addresses
  • Large sets of options (>15): countries, cities, product models
  • When you want semantic similarity matching for entity resolution
  • Dynamic or frequently changing value sets

Unique Identifiers & Entity Resolution:

  • Properties marked as unique_identifiers are used for entity deduplication and merging
  • With enum_values: Exact matching is used - entities with the same enum value are considered identical
  • Without enum_values: Semantic similarity matching is used - entities with similar meanings are automatically merged
  • Example: A "name" unique_identifier without enums will merge "Apple Inc" and "Apple Inc." as the same entity
  • Example: A "sku" unique_identifier with enums will only merge entities with exactly matching SKU codes
  • Use enums for unique_identifiers when you have a limited, predefined set of values (≤15 options)
  • Avoid enums for unique_identifiers when you have broad, open-ended values or >15 possible options
  • Best practices: Use enums for controlled vocabularies (status codes, categories), avoid for open text (company names, product titles)
  • In the example above: "name" uses semantic similarity (open-ended), "sku" uses exact matching (controlled set)

LLM-Friendly Descriptions:

  • Write detailed property descriptions that guide the LLM on expected formats and usage
  • Include examples of typical values (e.g., "Product name, typically 2-4 words like 'iPhone 15 Pro'")
  • Specify data formats and constraints clearly (e.g., "Price in USD as decimal number")
  • For enums, explain when to use each option (e.g., "use 'new' for brand new items")

Authentication Required: One of the following authentication methods must be used:

  • Bearer token in Authorization header
  • API Key in X-API-Key header
  • Session token in X-Session-Token header

Required Headers:

  • Content-Type: application/json
  • X-Client-Type: (e.g., 'papr_plugin', 'browser_extension')
Bodyapplication/jsonrequired
idstring(Id)
namestring(Name)[ 1 .. 100 ] charactersrequired
descriptionDescription (string) or Description (null)(Description)
Any of:
<= 500 characters
string(Description)<= 500 characters
versionstring(Version)^\d+\.\d+\.\d+$
Default "1.0.0"
user_idUser Id (string) or User Id (object) or User Id (null)(User Id)
Any of:
string(User Id)
workspace_idWorkspace Id (string) or Workspace Id (object) or Workspace Id (null)(Workspace Id)
Any of:
string(Workspace Id)
organization_idOrganization Id (string) or Organization Id (null)(Organization Id)

Organization ID this schema belongs to. Accepts legacy 'organization' alias.

Any of:

Organization ID this schema belongs to. Accepts legacy 'organization' alias.

string(Organization Id)

Organization ID this schema belongs to. Accepts legacy 'organization' alias.

namespace_idNamespace Id (string) or Namespace Id (null)(Namespace Id)

Namespace ID this schema belongs to. Accepts legacy 'namespace' alias.

Any of:

Namespace ID this schema belongs to. Accepts legacy 'namespace' alias.

string(Namespace Id)

Namespace ID this schema belongs to. Accepts legacy 'namespace' alias.

node_typesobject(Node Types)

Custom node types (max 10 per schema)

relationship_typesobject(Relationship Types)

Custom relationship types (max 20 per schema)

memory_policyMemory Policy (object) or Memory Policy (null)(Memory Policy)

Default memory policy for memories using this schema. Includes mode ('auto', 'manual'), node_constraints (applied in auto mode when present), and OMO safety settings (consent, risk). Memory-level policies override schema-level.

Any of:

Default memory policy for memories using this schema. Includes mode ('auto', 'manual'), node_constraints (applied in auto mode when present), and OMO safety settings (consent, risk). Memory-level policies override schema-level.

statusstring(SchemaStatus)
Default "draft"
Enum"draft""active""deprecated""archived"
scopestring(SchemaScope)

Schema scopes available through the API

Default "organization"
Enum"personal""workspace""namespace""organization"
created_atstring(date-time)(Created At)
updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:
string(date-time)(Updated At)
read_accessArray of strings(Read Access)
write_accessArray of strings(Write Access)
usage_countinteger(Usage Count)
Default 0
last_used_atLast Used At (string) or Last Used At (null)(Last Used At)
Any of:
string(date-time)(Last Used At)
organizationOrganization (string) or Organization (object) or Organization (null)(Organization)Deprecated

DEPRECATED: Use 'organization_id' instead. Accepts Parse pointer or objectId.

Any of:
Deprecated

DEPRECATED: Use 'organization_id' instead. Accepts Parse pointer or objectId.

string(Organization)

DEPRECATED: Use 'organization_id' instead. Accepts Parse pointer or objectId.

namespaceNamespace (string) or Namespace (object) or Namespace (null)(Namespace)Deprecated

DEPRECATED: Use 'namespace_id' instead. Accepts Parse pointer or objectId.

Any of:
Deprecated

DEPRECATED: Use 'namespace_id' instead. Accepts Parse pointer or objectId.

string(Namespace)

DEPRECATED: Use 'namespace_id' instead. Accepts Parse pointer or objectId.

curl -i -X POST \
  http://memory.papr.ai/v1/schemas \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "id": "string",
    "name": "string",
    "description": "string",
    "version": "1.0.0",
    "user_id": "string",
    "workspace_id": "string",
    "organization_id": "string",
    "namespace_id": "string",
    "organization": "string",
    "namespace": "string",
    "node_types": {
      "property1": {
        "name": "string",
        "label": "string",
        "description": "string",
        "properties": {
          "property1": {
            "type": "string",
            "required": false,
            "default": {},
            "description": "string",
            "min_length": 0,
            "max_length": 0,
            "min_value": 0,
            "max_value": 0,
            "enum_values": [
              "string"
            ],
            "pattern": "string"
          },
          "property2": {
            "type": "string",
            "required": false,
            "default": {},
            "description": "string",
            "min_length": 0,
            "max_length": 0,
            "min_value": 0,
            "max_value": 0,
            "enum_values": [
              "string"
            ],
            "pattern": "string"
          }
        },
        "required_properties": [
          "string"
        ],
        "unique_identifiers": [
          "string"
        ],
        "constraint": {
          "name": "Schema Level - Task with Multiple Match Strategies",
          "summary": "Define unique identifiers for Task nodes (node_type implicit at schema level)",
          "value": {
            "create": "auto",
            "search": {
              "properties": [
                {
                  "name": "id",
                  "mode": "exact"
                },
                {
                  "name": "title",
                  "mode": "semantic",
                  "threshold": 0.85
                }
              ]
            }
          }
        },
        "resolution_policy": "upsert",
        "link_only": false,
        "color": "#3498db",
        "icon": "string"
      },
      "property2": {
        "name": "string",
        "label": "string",
        "description": "string",
        "properties": {
          "property1": {
            "type": "string",
            "required": false,
            "default": {},
            "description": "string",
            "min_length": 0,
            "max_length": 0,
            "min_value": 0,
            "max_value": 0,
            "enum_values": [
              "string"
            ],
            "pattern": "string"
          },
          "property2": {
            "type": "string",
            "required": false,
            "default": {},
            "description": "string",
            "min_length": 0,
            "max_length": 0,
            "min_value": 0,
            "max_value": 0,
            "enum_values": [
              "string"
            ],
            "pattern": "string"
          }
        },
        "required_properties": [
          "string"
        ],
        "unique_identifiers": [
          "string"
        ],
        "constraint": {
          "name": "Schema Level - Task with Multiple Match Strategies",
          "summary": "Define unique identifiers for Task nodes (node_type implicit at schema level)",
          "value": {
            "create": "auto",
            "search": {
              "properties": [
                {
                  "name": "id",
                  "mode": "exact"
                },
                {
                  "name": "title",
                  "mode": "semantic",
                  "threshold": 0.85
                }
              ]
            }
          }
        },
        "resolution_policy": "upsert",
        "link_only": false,
        "color": "#3498db",
        "icon": "string"
      }
    },
    "relationship_types": {
      "property1": {
        "name": "string",
        "label": "string",
        "description": "string",
        "properties": {
          "property1": {
            "type": "string",
            "required": false,
            "default": {},
            "description": "string",
            "min_length": 0,
            "max_length": 0,
            "min_value": 0,
            "max_value": 0,
            "enum_values": [
              "string"
            ],
            "pattern": "string"
          },
          "property2": {
            "type": "string",
            "required": false,
            "default": {},
            "description": "string",
            "min_length": 0,
            "max_length": 0,
            "min_value": 0,
            "max_value": 0,
            "enum_values": [
              "string"
            ],
            "pattern": "string"
          }
        },
        "allowed_source_types": [
          "string"
        ],
        "allowed_target_types": [
          "string"
        ],
        "cardinality": "one-to-one",
        "constraint": {
          "name": "Schema Level - Controlled Vocabulary Edge",
          "summary": "Link to existing targets only, don'\''t create new (edge_type implicit)",
          "value": {
            "create": "never",
            "search": {
              "properties": [
                {
                  "name": "name",
                  "mode": "semantic",
                  "threshold": 0.9
                }
              ]
            }
          }
        },
        "resolution_policy": "upsert",
        "link_only": false,
        "color": "#e74c3c"
      },
      "property2": {
        "name": "string",
        "label": "string",
        "description": "string",
        "properties": {
          "property1": {
            "type": "string",
            "required": false,
            "default": {},
            "description": "string",
            "min_length": 0,
            "max_length": 0,
            "min_value": 0,
            "max_value": 0,
            "enum_values": [
              "string"
            ],
            "pattern": "string"
          },
          "property2": {
            "type": "string",
            "required": false,
            "default": {},
            "description": "string",
            "min_length": 0,
            "max_length": 0,
            "min_value": 0,
            "max_value": 0,
            "enum_values": [
              "string"
            ],
            "pattern": "string"
          }
        },
        "allowed_source_types": [
          "string"
        ],
        "allowed_target_types": [
          "string"
        ],
        "cardinality": "one-to-one",
        "constraint": {
          "name": "Schema Level - Controlled Vocabulary Edge",
          "summary": "Link to existing targets only, don'\''t create new (edge_type implicit)",
          "value": {
            "create": "never",
            "search": {
              "properties": [
                {
                  "name": "name",
                  "mode": "semantic",
                  "threshold": 0.9
                }
              ]
            }
          }
        },
        "resolution_policy": "upsert",
        "link_only": false,
        "color": "#e74c3c"
      }
    },
    "memory_policy": {},
    "status": "draft",
    "scope": "personal",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "read_access": [
      "string"
    ],
    "write_access": [
      "string"
    ],
    "usage_count": 0,
    "last_used_at": "2019-08-24T14:15:22Z"
  }'

Responses

Successful Response

Bodyapplication/json
successboolean(Success)required
dataUserGraphSchema (object) or null
Any of:

Complete user-defined graph schema

errorError (string) or Error (null)(Error)
Any of:
string(Error)
codeinteger(Code)
Default 200
Response
application/json
{
  "success": true,
  "data": {
    "id": "string",
    "name": "string",
    "description": "string",
    "version": "1.0.0",
    "user_id": "string",
    "workspace_id": "string",
    "organization_id": "string",
    "namespace_id": "string",
    "organization": "string",
    "namespace": "string",
    "node_types": { … },
    "relationship_types": { … },
    "memory_policy": {},
    "status": "draft",
    "scope": "personal",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "read_access": [ … ],
    "write_access": [ … ],
    "usage_count": 0,
    "last_used_at": "2019-08-24T14:15:22Z"
  },
  "error": "string",
  "code": 200
}

List User Schemas V1

Request

List all schemas accessible to the authenticated user.

Returns schemas that the user owns or has read access to, including:

  • Personal schemas created by the user
  • Workspace schemas shared within the user's workspace (legacy)
  • Namespace schemas shared within the user's namespace
  • Organization schemas available to the user's organization

Authentication Required: One of the following authentication methods must be used:

  • Bearer token in Authorization header
  • API Key in X-API-Key header
  • Session token in X-Session-Token header
Query
workspace_idWorkspace Id (string) or Workspace Id (null)(Workspace Id)

Filter by workspace ID

Any of:

Filter by workspace ID

string(Workspace Id)

Filter by workspace ID

status_filterStatus Filter (string) or Status Filter (null)(Status Filter)

Filter by status (draft, active, deprecated, archived)

Any of:

Filter by status (draft, active, deprecated, archived)

string(Status Filter)

Filter by status (draft, active, deprecated, archived)

curl -i -X GET \
  'http://memory.papr.ai/v1/schemas?status_filter=string&workspace_id=string' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Schemas retrieved successfully

Bodyapplication/json
successboolean(Success)required
dataArray of Data (objects) or Data (null)(Data)
Any of:
errorError (string) or Error (null)(Error)
Any of:
string(Error)
codeinteger(Code)
Default 200
totalinteger(Total)
Default 0
Response
application/json
{
  "success": true,
  "data": [
    { … }
  ],
  "code": 200,
  "total": 1
}

Memory

Operations

User

Operations

Feedback

Operations

Schema Management

Operations

Messages

Operations

omo

Operations

Sync

Operations

Telemetry

Operations

Document

Operations

GraphQL

Operations

Authentication

Operations