PApapr-ai
v1
Memory

Add Memory Batch V1

Changed on

Add multiple memory items in a batch with size validation and background processing.

**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')

The API validates individual memory content size against MAX_CONTENT_LENGTH environment variable (defaults to 15000 bytes).
post/v1/memory/batch

Request

  • Base URL
    https://memory.papr.ai
  • URL
    https://memory.papr.ai/v1/memory/batch
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Query parameters

skip_background_processingboolean

If True, skips adding background tasks for processing

enable_holographicboolean

If True, applies holographic neural transforms and stores in holographic collection

frequency_schema_idstring nullable

Frequency schema for holographic embedding (e.g. 'cosqa', 'scifact'). Required when enable_holographic=True. Call GET /v1/frequencies to see available schemas.

Request body

external_user_idstring nullable

Your application's user identifier for all memories in the batch. This is the primary way to identify users. Papr will automatically resolve or create internal users as needed.

user_idstring nullable

DEPRECATED: Use 'external_user_id' instead. Internal Papr Parse user ID.

organization_idstring nullable

DEPRECATED - Internal only. Auto-populated from API key scope. Do not set manually. The organization is resolved automatically from the API key's associated organization.

namespace_idstring nullable

Optional namespace ID for multi-tenant batch memory scoping. When provided, all memories in the batch are associated with this namespace.

batch_sizeinteger nullable

Number of items to process in parallel

webhook_urlstring nullable

Optional webhook URL to notify when batch processing is complete. The webhook will receive a POST request with batch completion details.

webhook_secretstring nullable

Optional secret key for webhook authentication. If provided, will be included in the webhook request headers as 'X-Webhook-Secret'.

Example request

{
  "batch_size": 10,
  "external_user_id": "external_user_abcde",
  "memories": [
    {
      "content": "Meeting notes from the product planning session",
      "metadata": {
        "createdAt": "2024-03-21T10:00:00Z",
        "emoji tags": "📊,💡,📝",
        "emotion tags": "focused, productive",
        "hierarchical structures": "Business/Planning/Product",
        "topics": "product, planning"
      },
      "type": "text"
    },
    {
      "content": "Follow-up tasks from the planning meeting",
      "metadata": {
        "createdAt": "2024-03-21T11:00:00Z",
        "emoji tags": "✅,📋",
        "emotion tags": "organized",
        "hierarchical structures": "Business/Tasks/Planning",
        "topics": "tasks, planning"
      },
      "type": "text"
    }
  ],
  "user_id": "internal_user_id_12345"
}

Response

Memories successfully added

codeinteger

HTTP status code for the batch operation

statusstring

'success', 'partial', or 'error'

messagestring nullable

Human-readable status message

errorstring nullable

Batch-level error message, if any

detailsunknown
batch_idstring nullable

Batch tracking ID for status polling via GET /v1/memory/batch/status/{batch_id} and WebSocket updates

total_processedinteger
total_successfulinteger
total_failedinteger
total_content_sizeinteger
total_storage_sizeinteger

Changes

  • f29d29d1ad16Revision changes
    • breaking

      removed from the //// request property anyOf list

    • info

      added the new optional query request parameter enable_holographic

    • info

      added the new optional query request parameter frequency_schema_id

    • info

      added subschema #1 to the //// request property anyOf list

  • 22d84aa060d6Revision changes
    • breaking

      removed subschema #1 from the //// request property anyOf list

    • warning

      deleted the query request parameter enable_holographic

    • warning

      deleted the query request parameter frequency_schema_id

    • info

      added to the //// request property anyOf list