Troubleshooting

Common Issues & Solutions

Issue: "Vault not found"

Cause: Invalid vault ID or wrong organization Solution:

• Verify vault ID is correct
• List vaults to see what you have access to
• Check API key has vault permission

Issue: Upload URL expired

Cause: Presigned URLs expire after 1 hour Solution:

• Request a new upload URL
• Upload immediately after getting URL
• For large files, use multipart upload (future feature)

Issue: Ingestion stuck on "processing"

Cause: OCR taking longer than expected or failed Solution:

• Check object status with GET /vault/:id/objects/:objectId
• Look at ingestionStatus and error details
• Very large documents can take 20+ minutes
• Failed ingestion can be retried

Issue: "Document too large"

Cause: File exceeds 500MB limit Solution:

• Split document into smaller parts
• Compress images in PDF
• Or contact support for large file handling