# Argo v3.1.12

2026-01-22 · [Original release notes](https://github.com/argoproj/argo-cd/releases/tag/v3.1.12) · [Full summary](https://ratatosk.io/en/releases/argo/v3.1.12)

Breaking changes 1 · Important fixes 1 · Other changes 1

## Check before upgrading

### Upgrade guide

- **Upgrade documentation for different minor versions**
  > If upgrading from a different minor version, be sure to read the [upgrading](https://argo-cd.readthedocs.io/en/stable/operator-manual/upgrading/overview/) documentation.

## Breaking changes (1)

### Health check failure logging corrected

- Affects: health checks served by `ServeHealthCheck`, including repo-server `/healthz?full=true` liveness checks

When the repo-server `/healthz?full=true` liveness check failed, the log was invalid and confusing, including a representation of the HTTP response writer instead of a useful health-check error. Failed-check logs now have a useful error message and structured `duration`, `component`, and `error` fields.

Evidence: “This PR fixes the error message and, additionally, it adds the "duration" field to the message that prints duration of the failed healthcheck: this can be useful for troubleshooting healthcheck failures.” https://github.com/argoproj/argo-cd/pull/26039

> * 1b7cfc0c0682118b04058419976d90152723a6d0: fix: invalid error message on health check failure (#26040) (cherry pick #26039 for 3.1) (#26071) (@dudinea)

## Important fixes (1)

### Source-specific refresh paths for hydrated applications

- Affects: applications using the `argocd.argoproj.io/manifest-generate-paths` annotation with source hydration enabled

Previously, the helper applied the same app-level paths to each source, so relative annotation paths for hydrated applications were based on `syncSource` rather than `drySource` and could fail to trigger refreshes. Now, annotation paths based on `drySource` trigger hydration refreshes, webhook changes in `drySource` trigger hydration, and `syncSource` changes refresh without hydration.

> * 28b618775d16e1259448b13414c5f789c1990afd: fix: cherry pick #25516 to release-3.1 (#26116) (@FourFifthsCode)

## Other changes (1)

- Hydrator revision rows shown only when required data is present

---

Summaries are produced by AI, so they can be wrong, and they are provided without warranty.
