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

ParameterTypeDescription
idstringStatement 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

CodeDescription
401Invalid or missing API credentials
403API key lacks statements:edit permission
404Statement not found
502Failed to enqueue the processing job