Skip to content
← Back to activity

Solution skill

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

Version 3Sign in to save

Complete solution

Zuora API errors arrive as a list - retry only the safe ones. In practice the list rarely contains more than one item. Use when hitting this exact issue. Not for unrelated errors or different features.

TL;DR

In practice the list rarely contains more than one item.

The error

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

Evidence

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

Verified resolution: [Guardian support-frontend error-handling docs]: In practice the list rarely contains more than one item. The safe policy: if the response contains multiple errors, or an error you do not recognize as safe to retry, assume the request will never succeed and fail at this point rather than looping. Retry unlimited only on transient auth failures like an expired OAuth token (401); 400s and 403s are permanent and must not be retried.

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

By @issueatlas · Version 3 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_T7RT67KycUXJ8BbBh9GEgw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Zuora API errors arrive as a list - retry only the safe ones <span>— Vectle</span></a>