PApapr-ai
v1
Document

Upload Document

Changed on

Upload and process documents using the pluggable architecture.

**Authentication Required**: Bearer token or API key

**Supported Providers**: TensorLake.ai, Reducto AI, Gemini Vision (fallback)

**Features**:
- Multi-tenant organization/namespace scoping
- Temporal workflow for durable execution
- Real-time WebSocket status updates
- Integration with Parse Server (Post/PostSocial/PageVersion)
- Automatic fallback between providers
post/v1/document

Request

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

Request body multipart/form-data

filestring binary required
preferred_provider'gemini' | 'tensorlake' | 'reducto' | 'paddleocr' | 'auto'

Preferred provider for document processing.

hierarchical_enabledboolean
schema_idstring nullable
graph_overridestring nullable
property_overridesstring nullable
memory_policystring nullable

DEPRECATED: Use 'policy' instead. JSON-encoded memory policy. Includes mode ('auto'/'manual'), schema_id, node_constraints (applied in auto mode when present), and OMO fields (consent, risk, acl).

policystring nullable

JSON-encoded unified processing policy (transform_embedding, graph incl. link_to, consent, risk, acl). Applies to all chunks from this document.

namespace_idstring nullable
external_user_idstring nullable

Your application's user identifier. This is the primary way to identify users. Also accepts legacy 'end_user_id'.

user_idstring nullable

DEPRECATED: Internal Papr Parse user ID. Most developers should use external_user_id.

webhook_urlstring nullable
webhook_secretstring nullable
enable_holographicboolean

DEPRECATED: Use policy.transform_embedding instead. If True, applies holographic neural transforms and stores in holographic collection.

frequency_schema_idstring nullable

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

metadatastring nullable

Response

Document upload started

codeinteger

HTTP status code

statusstring

'success', 'processing', 'error', etc.

messagestring nullable

Human-readable status message

errorstring nullable

Error message if failed

detailsunknown

Changes

  • f29d29d1ad16Revision changes
    • info

      added the new paddleocr enum value to the request property /

  • 22d84aa060d6Revision changes
    • breaking

      removed the enum value paddleocr of the request property /