Skip to content

Evidence and audit pack

Uploading and linking evidence, SHA-256 hashing and the download check, deletion rules, CSV exports and the audit pack.


Uploading evidence

Attach a file from a task, an obligation or a filing with Attach evidence, or add one from the Evidence page with Upload unlinked file. Members, admins and owners can upload. A file can be linked to a task, an obligation and a filing, and can carry a note.

Any file type is accepted. The size limit is the API's upload limit: 25 MB by default, 4 MB on serverless hosts such as Vercel, or MAX_UPLOAD_MB if it's set. Empty files are refused.

Hashing and integrity

At upload, Obligraph records the file's SHA-256 hash, size, type, uploader and time. Files are never changed after upload. The Evidence register lists every file with its SHA-256 fingerprint, and you can search by file name, uploader or hash prefix.

On every download, the API recomputes the SHA-256 of the stored bytes and compares it with the hash recorded at upload. If they differ, the download is refused (HTTP 410). A successful download carries the recorded hash in the X-Content-SHA256 response header, and the app shows it once the file is saved.

Files are stored on disk under STORAGE_DIR, or in Postgres on serverless hosts. The original file name is kept only in the database, never in a file path.

Deleting evidence

Only admins and owners can delete evidence. A file that backs an approved maker-checker decision can't be deleted: the API returns 409 Conflict. Each deletion is recorded in the activity log with the file's name and hash.

CSV exports

On Reports, the Exports panel offers these CSV downloads to members, admins and owners:

ExportContents
ObligationsCoverage, status, owner, gap, remediation and policy quotes
TasksRemediation work, assignees and due dates
ApprovalsMaker, checker, notes, decision and history
EvidenceFiles with SHA-256, size and links
FilingsPeriods, due and filed dates, references
Activity logWho changed what
PoliciesUploaded documents

Audit pack

Audit pack (.zip) is for admins and owners. The zip, named obligraph-audit-<workspace id>-<yyyymmdd>.zip, contains:

  • every export above as a CSV file;
  • every evidence file, under evidence/, named <evidence id>_<original name>;
  • manifest.json, listing each file's size and, for evidence, the SHA-256 recorded at upload;
  • README.txt, explaining the layout.

If an evidence file fails its integrity check while the pack is built, it's left out and the manifest records the error. Each audit pack download is recorded in the activity log.