API reference · Knowledge

Read a document again

POSThttps://goblins-call-api.onrender.com/v1/knowledge/documents/:id/retry

Reads a failed document again from what was kept of it.

Needs a workspace API key.

Path parameters

idstringRequired

The document’s ID, such as kd_4b1f0c9d2e7a6f53.

Errors

402INSUFFICIENT_BALANCE

The workspace balance is zero or below.

404

No document in your workspace has that ID.

429RATE_LIMITED

The workspace has added too many documents in an hour. Reading one again counts as adding one.

Every request can also answer 401, 429 and 500: see Errors.

Notes

  • Only a failed document is read again. One that is ready or processing comes back as it is.
  • A document whose reading was interrupted turns failed within a few minutes, with “Processing was interrupted. Try again.” in error.
curl -X POST "https://goblins-call-api.onrender.com/v1/knowledge/documents/kd_4b1f0c9d2e7a6f53/retry" \
  -H "Authorization: Bearer $CRACKLE_API_KEY"
Response · 202 Accepted
{
  "document": { "id": "kd_4b1f0c9d2e7a6f53", "status": "processing", … }
}