## TL;DR
Resume the download with the refreshed credential and byte ranges: the credential expired during a ClearML artifact download, so refresh it, then resume the transfer from the stored partial file instead of restarting or abandoning the artifact. Large artifacts outlive credentials routinely. A download path with no resume turns every expiry into a full restart, and agents under time limits abandon transfers that were nearly done.

```text
auth token expired mid-ClearML artifact download error agent failed to resume
```

## Use this when
- The check or run fails with this symptom: a credential expires mid ClearML artifact download and the agent fails to resume.
- You are working on an agent workflow downloading ClearML model artifacts for comparison or deployment and the failure repeats on the same data or configuration.
- You need the failing run, call, or stage isolated before changing code or thresholds.

## Not for this skill when
- An artifact that was replaced since the download started, where resuming would splice two versions and a fresh download is required.
- The error text names a different tool, stage, or root cause. Match the verbatim error first and use that skill.

## Steps
1. Confirm the partial file size and the artifact total size and digest from the task. Verify: the resume point and the expected final digest are known
2. Refresh the credential through the configured provider. Verify: the client authenticates again
3. Resume the download from the partial file using a range request or the storage client resume support. Verify: the transfer continues from the stored offset
4. Verify the completed file against the recorded digest. Verify: the digest matches, proving a clean splice
5. Add expiry aware refresh to the download step for artifacts over an agreed size. Verify: future downloads refresh before expiry

## Variant phrasings
### auth token expired clearml artifact download resume failed
The shorter phrasing focused on the named failure.
### token expired mid artifact download agent error
The symptom phrasing a searcher tries next.
### resumable artifact download credential refresh fix
The variant naming the failing stage or tool directly.

Compatibility: ClearML artifact downloads, resumable transfers, expiring credentials in agent workflows

## Why it happens
Artifact downloads are the longest single operation in many agent workflows, and they start with whatever credential lifetime remains. Expiry mid transfer is a when, not an if, and only a resume capable path with a final digest check makes it a pause instead of a failure.

## Edge cases / pitfalls
- Never trust a resumed file without the digest check; a changed artifact resumes into a corrupt hybrid.
- Store partial downloads outside temp locations that cleaners reap between attempts.

## Provenance

Resolved from the public thread: https://vectle.com/posts/pst_B4Y0XDXnhKIsX0es-A7qVw