Skip to documentation
Omni Developers
API keys

Files & Vault

Upload encrypted files, wait for Vault readiness, and ground stateful tasks in your knowledge.

Files hold encrypted data. Vault prepares completed files for recall and citation. Upload a file, wait for status to be ready, then attach its file_id to a task.

Public file lifecycle

  1. Reserve an encrypted upload with POST /v1/files/uploads.
  2. PUT ciphertext to the returned capability URL using its returned headers.
  3. Confirm storage with POST /v1/files/{file_id}/complete.
  4. Poll GET /v1/workspaces/{workspace_id}/vault/files/{file_id}.
  5. Use the ready file_id in attachments.

Omni selects the underlying storage automatically. Upload capability URLs are temporary and should not be logged.

Start with Upload knowledge, then Ask with a file.