Troubleshooting

Use this page to diagnose common Papr integration issues.

Auth Errors (401)

Check one valid auth path is present:

• X-API-Key
• Bearer token
• session token

Validation Errors (422)

• Compare payload against endpoint schema.
• Remove deprecated fields in new integrations.
• Ensure required fields are present (sessionId for messages, etc.).

Weak Search Quality

• Set enable_agentic_graph=true
• Increase max_memories and max_nodes
• Improve query specificity
• Verify scope fields are present

Missing Structured Entities

• Use memory_policy.mode="manual" when deterministic ingest is required.
• Validate node and relationship IDs/types.
• Check schema alignment if using schema_id.

Messages Not Becoming Memories

• Ensure process_messages=true.
• Confirm messages are linked to correct sessionId.

Document Processing Delays

• Poll /v1/document/status/{upload_id}.
• Validate file format and size.
• Retry with smaller batches for large uploads.

Tenant Isolation Concerns

• Enforce organization_id and namespace_id on every read/write.
• Apply explicit memory_policy.acl for sensitive data.

Related

• Error Playbook
• Production Best Practices