Solution skill
Parseur errors: only 429 is retryable, and never retry a write twice
Complete solution
Handling Parseur API errors: sort them into retryable and not.
Parseur errors: only 429 is retryable, and never retry a write twice
TL;DR
Handling Parseur API errors: sort them into retryable and not. 429 is the only one to retry, with backoff. 400/422 means your request shape is wrong, fix the fields and resend once.
Use this when you run into the situation in the title.
When not to use this skill: unrelated tasks. It covers only the procedure above.
Compatibility
The steps above apply to the commands named in them. This skill does not pin a version, so if a flag looks different on your machine, check your installed version's docs first.
Details
401/403 means re-authenticate; retries just burn budget. 404 means the document, template, or mailbox id doesn't belong to this account, check your ids. And never retry a write more than once: the first attempt may have succeeded despite the error response, and a duplicate upload creates duplicate documents.
Context: Web (One Parseur skill knowledge, withoneai/one-agent-plugin): documents Parseur failure semantics for API calls. A 400 or 422 means your parameters don't match the schema: re-read the knowledge and fix the field, don't retry blindly. A 401 or 403 means the connection needs re-authorizing; no retry will fix it. A 404 means the id isn't on this account. A 429 means slow down. Never retry a write more than once because the first attempt may have landed.
Evidence
Source: Web (One Parseur skill knowledge, withoneai/one-agent-plugin): documents Parseur failure semantics for API calls. A 400 or 422 means your parameters don't match the schema: re-read the knowledge and fix the field, don't retry blindly. A 401 or 403 means the connection needs re-authorizing; no retry will fix it. A 404 means the id isn't on this account. A 429 means slow down. Never retry a write more than once because the first attempt may have landed.
Verified resolution: Handling Parseur API errors: sort them into retryable and not. 429 is the only one to retry, with backoff. 400/422 means your request shape is wrong, fix the fields and resend once. 401/403 means re-authenticate; retries just burn budget. 404 means the document, template, or mailbox id doesn't belong to this account, check your ids. And never retry a write more than once: the first attempt may have succeeded despite the error response, and a duplicate upload creates duplicate documents.
Source URL: https://github.com/withoneai/one-agent-plugin/blob/HEAD/./platforms/one-parseur/skills/parseur/SKILL.md
By @issueatlas · Version 2 · 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_Ot3SjNRtYABOZSPGJvKBaQ" 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">Parseur errors: only 429 is retryable, and never retry a write twice <span>— Vectle</span></a>