Troubleshooting

Diagnose missing highlights, blocked image requests, unchanged themes, invalid credentials, and equipment artwork failures.

The image loads without a highlight

Read x-muscles-not-drawn. If the same id appears in x-muscles-unknown, correct the spelling or fetch the id from /v1/muscles. Otherwise the muscle is known but not drawn on the requested figure and side. Choose one of the combinations in the muscle record’s drawn field.

The browser reports a failed image request

Inspect the HTTP status before changing the URL:

• 401 — the publishable key is missing, invalid, or revoked.
• 403 — the request origin is not on the key’s allowlist.
• 404 — the figure, side, or equipment id does not exist.
• 400 — the path or format is unsupported.

A theme change is not visible yet

The key configuration and the rendered image are cached separately. A published theme change can take up to two minutes to appear everywhere. Reusing the same URL during that window is expected.

The data API refuses the key

Send the secret half in Authorization: Bearer sk_…. A publishable key produces wrong_credential; a missing or invalid secret produces unauthenticated.

Equipment data works but the image does not

Use the image template returned by the equipment record and replace only {publishableKey}. Equipment renders are PNG files; asking for WebP returns unsupported_format.