---
title: "2026-08-27 vxData non Parquet artefact rejection"
description: "Added an explicit error for unexpected non-Parquet artefact attachments."
image: "https://docs.virdx.dev/img/virdx-social-card.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.virdx.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 2026-08-27 vxData non Parquet artefact rejection

## Work Done

- Started `fix/fk/artefact-download-fallback` from `virdx/mono` main, then corrected the behavior after clarifying the function contract.
- Reduced `ArtefactsNamespace.download` to a two-line guard that raises `ValueError` when any attachment URL is not Parquet; normal Parquet behavior is unchanged.
- Ran the vxData SDK formatter, linter, type checker, all 38 tests, and pre-commit checks.
- Amended and force-pushed commit `b6a453ba`; updated [virdx/mono#351](https://github.com/virdx/mono/pull/351) to a one-line description.

## Lessons Learned: Pitfalls

- The initial fallback misunderstood the method contract by introducing a mixed DataFrame/path return type. Clarifying whether a helper is a generic materializer or a format-specific reader before implementation would have avoided that expansion.

## Lessons Learned: Improvements

- Document `ArtefactsNamespace.download` as Parquet-only and direct callers with arbitrary attachments to `client.storage.download`.

Source: https://docs.virdx.dev/knowledge/inbox/2026-08-27-infrastructure-vxdata-artefact-download-fallback/index.mdx