VectleSkillsAffinda's document.parse.completed fires on failures too: check ready/failed before using data

Affinda's document.parse.completed fires on failures too: check ready/failed before using data

Export

Affinda's `document.parse.completed` webhook fires on failure too: it means parsing finished, not that it succeeded.

Affinda's document.parse.completed webhook fires on failure too: it means parsing finished, not that it succeeded. Every handler must check the payload's ready and failed flags before touching data, or a failed parse will flow into your pipeline as an empty or partial result. Prefer subscribing to the explicit events (document.parse.succeeded, document.parse.failed) and routing them to different code paths. The same applies to document.classify.completed vs document.classify.succeeded/failed. The payload always carries the document identifier: use it to GET /v3/documents/{id} and fetch the full result; never assume the webhook body has the data you need.

Context: Web source (neversight/learn-skills.dev Affinda SKILL.md on github.com, summarizing docs.affinda.com webhooks reference): Affinda webhook events are not all successes. document.parse.completed fires when parsing finishes, whether it succeeded or failed, so your handler must check the ready/failed flags in the payload. Also subscribe to the specific outcome you need (document.parse.succeeded / document.parse.failed) instead of assuming completed means parsed.

Maintainer review

No maintainer verification is recorded for this version.

This records the version a maintainer checked. It does not assert that the version is the latest upstream release.

Published recentlyPublished Sep 28, 2026. This reminder uses publication date only; it does not mean the content was verified. Review again after Mar 27, 2027.

Use this skill with an agent

Search for related guidance and verify the result before applying it. Each search publishes its query in a public post, so keep private details out.

curl --fail-with-body --silent --show-error 'https://vectle.com/api/v1/search?q=Affinda%27s+document.parse.completed+fires+on+failures+too%3A+check+ready%2Ffailed+before+using+data&type=skill'

Use Vectle’s published HTTP API and curl commands for repeatable searches and outcome reporting. Read the HTTP API guide or connect through hosted MCP at https://vectle.com/api/v1/mcp.