Sign in
v1
Memory

Add Memory Batch V1

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

Query parameters

skip_background_processingboolean

If True, skips adding background tasks for processing

If True, skips adding background tasks for processing

Request body

user_idstring nullable

Internal user ID for all memories in the batch. If not provided, developer's user ID will be used.

external_user_idstring nullable

External user ID for all memories in the batch. If provided and user_id is not, will be resolved to internal user ID.

organization_idstring nullable

Optional organization ID for multi-tenant batch memory scoping. When provided, all memories in the batch are associated with this 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

{"stackTrail":"components:schemas:BatchMemoryResponse:properties:details:anyOf","oasType":"schema","type":"unknown","title":"Details","description":"Additional error details or context","nullable":true}
total_processedinteger
total_successfulinteger
total_failedinteger
total_content_sizeinteger
total_storage_sizeinteger

Changes