API Reference
/
v1
/
Get a single domain by id

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://memory.papr.ai/

v1

Operations

Trigger LLM clustering on buffered signal values

Request

Process any buffered signal values through LLM clustering.

This merges raw signal values from recent transform calls into semantic clusters. Normally happens automatically every N transforms, but this endpoint lets you trigger it on-demand.

Path
domain_idstring(Domain Id)required
curl -i -X POST \
  'https://memory.papr.ai/v1/graph/domains/{domain_id}/catalog/refresh' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Successful Response

Bodyapplication/json
entity_clustersArray of objects(Entity Clusters)
relationship_patternsArray of objects(Relationship Patterns)
domain_distributionobject(Domain Distribution)

Signal band name -> total doc count.

signal_value_countsobject(Signal Value Counts)

Per-band raw value counts, e.g. {'domain': {'Health': 500, 'Tech': 200}}.

total_documentsinteger(Total Documents)

Total transforms processed.

Default 0
last_refreshedLast Refreshed (string) or Last Refreshed (null)(Last Refreshed)

ISO timestamp of last LLM clustering run.

Any of:

ISO timestamp of last LLM clustering run.

string(Last Refreshed)

ISO timestamp of last LLM clustering run.

last_updatedLast Updated (string) or Last Updated (null)(Last Updated)

ISO timestamp of last buffer append.

Any of:

ISO timestamp of last buffer append.

string(Last Updated)

ISO timestamp of last buffer append.

Response
application/json
{
  "entity_clusters": [
    { … }
  ],
  "relationship_patterns": [
    { … }
  ],
  "domain_distribution": {
    "property1": 0,
    "property2": 0
  },
  "signal_value_counts": {
    "property1": { … },
    "property2": { … }
  },
  "total_documents": 0,
  "last_refreshed": "string",
  "last_updated": "string"
}

Get a single domain by id

Request

Path
domain_idstring(Domain Id)required
curl -i -X GET \
  'https://memory.papr.ai/v1/graph/domains/{domain_id}' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Successful Response

Bodyapplication/json
domain_idstring(Domain Id)required
namestring(Name)required
descriptionstring(Description)required
signalsArray of objects(Signals)required
signals[].​namestring(Name)required

Snake_case signal identifier.

signals[].​descriptionstring(Description)required

Human prompt used by extractor.

signals[].​weightnumber(Weight)

Relative weight in the fusion.

Default 1
signals[].​frequency_hzFrequency Hz (number) or Frequency Hz (null)(Frequency Hz)

Hz band mapping (0.1 … 70.0). Auto-assigned if omitted.

Any of:

Hz band mapping (0.1 … 70.0). Auto-assigned if omitted.

number(Frequency Hz)

Hz band mapping (0.1 … 70.0). Auto-assigned if omitted.

signals[].​typestring(Type)

Extraction / phase type for this signal.

Default "text"
Enum"enum""text""numeric""date""boolean""multi_value_text"
signals[].​allowed_valuesArray of Allowed Values (strings) or Allowed Values (null)(Allowed Values)

For type='enum': allowed vocabulary.

Any of:

For type='enum': allowed vocabulary.

signals[].​requiredboolean(Required)

Warn when missing at extract time.

Default false
signal_multipliersSignal Multipliers (object) or Signal Multipliers (null)(Signal Multipliers)

Domain-level default signal multipliers (see GraphDomainCreate).

Any of:

Domain-level default signal multipliers (see GraphDomainCreate).

routing_configGraphDomainRoutingConfig (object) or null

Domain-level CAESAR-VIII routing config (see GraphDomainRoutingConfig).

Any of:

Domain-level CAESAR-VIII routing config (see GraphDomainRoutingConfig).

catalog_configDomainCatalogConfig (object) or null

Catalog settings (see DomainCatalogConfig).

Any of:

Catalog settings (see DomainCatalogConfig).

catalogDomainCatalog (object) or null

Curated catalog of signal values in this domain's frequency space.

Any of:

Curated catalog of signal values in this domain's frequency space.

catalog_bufferArray of objects(Catalog Buffer)

Buffered raw signals awaiting LLM clustering (internal).

builtinboolean(Builtin)

True for built-in domains shipped with Papr (read-only).

Default false
created_atCreated At (string) or Created At (null)(Created At)
Any of:
string(Created At)
owner_user_idOwner User Id (string) or Owner User Id (null)(Owner User Id)
Any of:
string(Owner User Id)
owner_workspace_idOwner Workspace Id (string) or Owner Workspace Id (null)(Owner Workspace Id)

Workspace that owns this domain. Domains are scoped to workspace when set.

Any of:

Workspace that owns this domain. Domains are scoped to workspace when set.

string(Owner Workspace Id)

Workspace that owns this domain. Domains are scoped to workspace when set.

owner_organization_idOwner Organization Id (string) or Owner Organization Id (null)(Owner Organization Id)

Organization that owns this domain.

Any of:

Organization that owns this domain.

string(Owner Organization Id)

Organization that owns this domain.

owner_namespace_idOwner Namespace Id (string) or Owner Namespace Id (null)(Owner Namespace Id)

Namespace this domain belongs to, if any.

Any of:

Namespace this domain belongs to, if any.

string(Owner Namespace Id)

Namespace this domain belongs to, if any.

Response
application/json
{
  "domain_id": "string",
  "name": "string",
  "description": "string",
  "signals": [
    { … }
  ],
  "signal_multipliers": {
    "property1": 0,
    "property2": 0
  },
  "routing_config": {
    "disabled_rules": [ … ],
    "enabled_rule_packs": [ … ],
    "threshold_overrides": { … },
    "enhanced_initial_source": "string",
    "holographic_floor": true,
    "ce_gate_min_phi": 0,
    "egr_lambda_ce": 0,
    "caesar4_source": "string"
  },
  "catalog_config": {
    "enabled": true,
    "refresh_every_n": 50
  },
  "catalog": {
    "entity_clusters": [ … ],
    "relationship_patterns": [ … ],
    "domain_distribution": { … },
    "signal_value_counts": { … },
    "total_documents": 0,
    "last_refreshed": "string",
    "last_updated": "string"
  },
  "catalog_buffer": [
    { … }
  ],
  "builtin": false,
  "created_at": "string",
  "owner_user_id": "string",
  "owner_workspace_id": "string",
  "owner_organization_id": "string",
  "owner_namespace_id": "string"
}

Update name, description, or signal_multipliers for a custom domain

Request

Path
domain_idstring(Domain Id)required
Bodyapplication/jsonrequired
nameName (string) or Name (null)(Name)

Updated human-readable name.

Any of:

Updated human-readable name.

string(Name)

Updated human-readable name.

descriptionDescription (string) or Description (null)(Description)

Updated description.

Any of:

Updated description.

string(Description)

Updated description.

signal_multipliersSignal Multipliers (object) or Signal Multipliers (null)(Signal Multipliers)

Replace the domain-level signal_multipliers entirely. Pass an empty dict {} to clear all multipliers. Omit the field to leave existing multipliers unchanged.

Any of:

Replace the domain-level signal_multipliers entirely. Pass an empty dict {} to clear all multipliers. Omit the field to leave existing multipliers unchanged.

routing_configGraphDomainRoutingConfig (object) or null

Replace the domain-level routing_config entirely. Pass null fields inside to clear. Omit to leave unchanged.

Any of:

Replace the domain-level routing_config entirely. Pass null fields inside to clear. Omit to leave unchanged.

catalog_configDomainCatalogConfig (object) or null

Update catalog settings. Pass {enabled: false} to disable signal accumulation. Omit to leave unchanged.

Any of:

Update catalog settings. Pass {enabled: false} to disable signal accumulation. Omit to leave unchanged.

curl -i -X PUT \
  'https://memory.papr.ai/v1/graph/domains/{domain_id}' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "name": "string",
    "description": "string",
    "signal_multipliers": {
      "property1": 0,
      "property2": 0
    },
    "routing_config": {
      "disabled_rules": [
        "string"
      ],
      "enabled_rule_packs": [
        "string"
      ],
      "threshold_overrides": {
        "property1": 0,
        "property2": 0
      },
      "enhanced_initial_source": "string",
      "holographic_floor": true,
      "ce_gate_min_phi": 0,
      "egr_lambda_ce": 0,
      "caesar4_source": "string"
    },
    "catalog_config": {
      "enabled": true,
      "refresh_every_n": 50
    }
  }'

Responses

Successful Response

Bodyapplication/json
domain_idstring(Domain Id)required
namestring(Name)required
descriptionstring(Description)required
signalsArray of objects(Signals)required
signals[].​namestring(Name)required

Snake_case signal identifier.

signals[].​descriptionstring(Description)required

Human prompt used by extractor.

signals[].​weightnumber(Weight)

Relative weight in the fusion.

Default 1
signals[].​frequency_hzFrequency Hz (number) or Frequency Hz (null)(Frequency Hz)

Hz band mapping (0.1 … 70.0). Auto-assigned if omitted.

Any of:

Hz band mapping (0.1 … 70.0). Auto-assigned if omitted.

number(Frequency Hz)

Hz band mapping (0.1 … 70.0). Auto-assigned if omitted.

signals[].​typestring(Type)

Extraction / phase type for this signal.

Default "text"
Enum"enum""text""numeric""date""boolean""multi_value_text"
signals[].​allowed_valuesArray of Allowed Values (strings) or Allowed Values (null)(Allowed Values)

For type='enum': allowed vocabulary.

Any of:

For type='enum': allowed vocabulary.

signals[].​requiredboolean(Required)

Warn when missing at extract time.

Default false
signal_multipliersSignal Multipliers (object) or Signal Multipliers (null)(Signal Multipliers)

Domain-level default signal multipliers (see GraphDomainCreate).

Any of:

Domain-level default signal multipliers (see GraphDomainCreate).

routing_configGraphDomainRoutingConfig (object) or null

Domain-level CAESAR-VIII routing config (see GraphDomainRoutingConfig).

Any of:

Domain-level CAESAR-VIII routing config (see GraphDomainRoutingConfig).

catalog_configDomainCatalogConfig (object) or null

Catalog settings (see DomainCatalogConfig).

Any of:

Catalog settings (see DomainCatalogConfig).

catalogDomainCatalog (object) or null

Curated catalog of signal values in this domain's frequency space.

Any of:

Curated catalog of signal values in this domain's frequency space.

catalog_bufferArray of objects(Catalog Buffer)

Buffered raw signals awaiting LLM clustering (internal).

builtinboolean(Builtin)

True for built-in domains shipped with Papr (read-only).

Default false
created_atCreated At (string) or Created At (null)(Created At)
Any of:
string(Created At)
owner_user_idOwner User Id (string) or Owner User Id (null)(Owner User Id)
Any of:
string(Owner User Id)
owner_workspace_idOwner Workspace Id (string) or Owner Workspace Id (null)(Owner Workspace Id)

Workspace that owns this domain. Domains are scoped to workspace when set.

Any of:

Workspace that owns this domain. Domains are scoped to workspace when set.

string(Owner Workspace Id)

Workspace that owns this domain. Domains are scoped to workspace when set.

owner_organization_idOwner Organization Id (string) or Owner Organization Id (null)(Owner Organization Id)

Organization that owns this domain.

Any of:

Organization that owns this domain.

string(Owner Organization Id)

Organization that owns this domain.

owner_namespace_idOwner Namespace Id (string) or Owner Namespace Id (null)(Owner Namespace Id)

Namespace this domain belongs to, if any.

Any of:

Namespace this domain belongs to, if any.

string(Owner Namespace Id)

Namespace this domain belongs to, if any.

Response
application/json
{
  "domain_id": "string",
  "name": "string",
  "description": "string",
  "signals": [
    { … }
  ],
  "signal_multipliers": {
    "property1": 0,
    "property2": 0
  },
  "routing_config": {
    "disabled_rules": [ … ],
    "enabled_rule_packs": [ … ],
    "threshold_overrides": { … },
    "enhanced_initial_source": "string",
    "holographic_floor": true,
    "ce_gate_min_phi": 0,
    "egr_lambda_ce": 0,
    "caesar4_source": "string"
  },
  "catalog_config": {
    "enabled": true,
    "refresh_every_n": 50
  },
  "catalog": {
    "entity_clusters": [ … ],
    "relationship_patterns": [ … ],
    "domain_distribution": { … },
    "signal_value_counts": { … },
    "total_documents": 0,
    "last_refreshed": "string",
    "last_updated": "string"
  },
  "catalog_buffer": [
    { … }
  ],
  "builtin": false,
  "created_at": "string",
  "owner_user_id": "string",
  "owner_workspace_id": "string",
  "owner_organization_id": "string",
  "owner_namespace_id": "string"
}

Memory

Operations

Memory Status

Operations

User

Operations

Feedback

Operations

Schema Management

Operations

Messages

Operations

omo

Operations

Namespace

Operations

Frequency Schemas

Operations

Holographic Transform (Deprecated)

Operations

Graph (CAESAR-8)

Operations

Graph Domains

Operations

Instance Configuration

Operations

AI Proxy

Operations

Sync

Operations

Telemetry

Operations

Document

Operations

GraphQL

Operations

Authentication

Operations