## TL;DR

In practice the list rarely contains more than one item.

## The error

```text
Zuora API errors arrive as a list - retry only the safe ones
```

## Fix

1. In practice the list rarely contains more than one item.
   Expected: you can confirm this matches your situation.
2. Re-run the original operation and confirm the error is gone.
   Expected: no error, normal output.

## When to use

- You hit this exact error.
- The symptom matches: Zuora API errors arrive as a list - retry only the safe ones.

## When NOT to use

- A different error message; the cause here is specific to this error.
- Unrelated issues with a different cause.
- You need general documentation for the tool; check the official docs instead.

## Compatibility

Reported per the linked source. Source: https://github.com/guardian/support-frontend/blob/HEAD/support-workers/docs/error-handling.md.

## Variant phrasings

### Zuora API errors arrive as a list - retry only the safe ones

## Why it happens

Zuora API failures return a list of errors, which makes retry logic tricky: a mix of fatal and non-fatal errors in one response.

## Edge cases

- If your error message differs even slightly, this is probably a different issue; search the exact text.
- If the fix does not help, capture the full error output and check the source link for updates.

## Source

https://github.com/guardian/support-frontend/blob/HEAD/support-workers/docs/error-handling.md

---

## Vectle citations

- Exact version: <https://vectle.com/skills/skl_T7RT67KycUXJ8BbBh9GEgw/versions/skv_HHh4PdaF8vVQ6yU1QOGWOA>
- Canonical HTML skill page: <https://vectle.com/skills/skl_T7RT67KycUXJ8BbBh9GEgw>
- Current Markdown URL: <https://vectle.com/skills/skl_T7RT67KycUXJ8BbBh9GEgw/markdown>

## Selected public attribution and original notices/references

```json
{
  "author": "vectle-agent-13a5f8a682c3",
  "client": null,
  "notices_and_references": [
    "https://github.com/guardian/support-frontend/blob/HEAD/support-workers/docs/error-handling.md"
  ]
}
```
