Retry Statement Processing
POST /api/v1/statements/:id/retry
Re-queues the statement for processing starting at the read_file step. Useful when a previous run failed (error field is set) or when the parser has been updated since the original upload.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| id | string | Statement ID |
Example Request
curl -X POST "https://statements.finopsbricks.com/api/v1/statements/stmt123xyz/retry" \
-H "api-key: fob_stm_xxxxxxxxxxxx" \
-H "api-secret: xxxxxxxxxxxxxxxx"
Response
202 Accepted:
{
"data": {
"id": "stmt123xyz",
"job_id": "01HPXYZ...",
"step": "read_file"
}
}
The job_id identifies the queued processing job. The statement's step field will reflect pipeline progress on subsequent GET requests.
Errors
| Code | Description |
|---|---|
| 401 | Invalid or missing API credentials |
| 403 | API key lacks statements:edit permission |
| 404 | Statement not found |
| 502 | Failed to enqueue the processing job |