API Reference
/
Graph Domains
/
Delete domain

Papr Memory API (1.0.0)

API for managing enterprise context and 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

Memory

Operations

Memory Status

Operations

User

Operations

Feedback

Operations

Schema Management

Operations

Messages

Operations

omo

Operations

Namespace

Operations

Graph

Operations

Graph Domains

Operations

List domains

Request

curl -i -X GET \
  https://memory.papr.ai/v1/graph/domains \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Successful Response

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

Snake_case signal identifier.

domains[].​signals[].​descriptionstring(Description)required

Human prompt used by extractor.

domains[].​signals[].​weightnumber(Weight)

Relative weight in the fusion.

Default 1
domains[].​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.

domains[].​signals[].​typestring(Type)

Extraction / phase type for this signal.

Default "text"
Enum"enum""text""numeric""date""boolean""multi_value_text"
domains[].​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.

domains[].​signals[].​requiredboolean(Required)

Warn when missing at extract time.

Default false
domains[].​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).

domains[].​routing_configGraphDomainRoutingConfig (object) or null

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

Any of:

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

domains[].​builtinboolean(Builtin)

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

Default false
domains[].​created_atCreated At (string) or Created At (null)(Created At)
Any of:
string(Created At)
domains[].​owner_user_idOwner User Id (string) or Owner User Id (null)(Owner User Id)
Any of:
string(Owner User Id)
domains[].​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.

domains[].​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.

domains[].​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
{
  "domains": [
    { … }
  ]
}

Create domain

Request

Bodyapplication/jsonrequired
domain_idstring(Domain Id)required

Custom id, e.g. 'acme:support_tickets:1.0.0'.

namestring(Name)required

Human-readable domain name.

descriptionstring(Description)required

What this domain models.

signalsArray of objects(Signals)non-emptyrequired

Per-domain signal definitions.

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 weight multipliers. Applied automatically on every rerank/search request for this domain (unless the caller supplies their own signal_multipliers, which take priority). Keys are field names (e.g. 'key_claim') or Hz-strings (e.g. '70.0'). Values: 0.0 = disable band, 1.0 = unchanged, 2.0 = 2× boost.

Any of:

Domain-level default signal weight multipliers. Applied automatically on every rerank/search request for this domain (unless the caller supplies their own signal_multipliers, which take priority). Keys are field names (e.g. 'key_claim') or Hz-strings (e.g. '70.0'). Values: 0.0 = disable band, 1.0 = unchanged, 2.0 = 2× boost.

routing_configGraphDomainRoutingConfig (object) or null

Domain-level CAESAR-VIII routing config: disabled global rules, enabled domain rule packs, optional threshold overrides.

Any of:

Domain-level CAESAR-VIII routing config: disabled global rules, enabled domain rule packs, optional threshold overrides.

curl -i -X POST \
  https://memory.papr.ai/v1/graph/domains \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "domain_id": "string",
    "name": "string",
    "description": "string",
    "signals": [
      {
        "name": "string",
        "description": "string",
        "weight": 1,
        "frequency_hz": 0,
        "type": "enum",
        "allowed_values": [
          "string"
        ],
        "required": false
      }
    ],
    "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"
    }
  }'

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).

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"
  },
  "builtin": false,
  "created_at": "string",
  "owner_user_id": "string",
  "owner_workspace_id": "string",
  "owner_organization_id": "string",
  "owner_namespace_id": "string"
}

Get domain

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).

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"
  },
  "builtin": false,
  "created_at": "string",
  "owner_user_id": "string",
  "owner_workspace_id": "string",
  "owner_organization_id": "string",
  "owner_namespace_id": "string"
}

Update 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.

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

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).

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"
  },
  "builtin": false,
  "created_at": "string",
  "owner_user_id": "string",
  "owner_workspace_id": "string",
  "owner_organization_id": "string",
  "owner_namespace_id": "string"
}

Delete domain

Request

Path
domain_idstring(Domain Id)required
curl -i -X DELETE \
  '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
deletedboolean(Deleted)required
Response
application/json
{
  "domain_id": "string",
  "deleted": true
}

Instance Configuration

Operations

AI Proxy

Operations

Sync

Operations

Telemetry

Operations

Document

Operations

GraphQL

Operations

Authentication

Operations