Skip to main content
Resolve a validation issue

Path Parameters

raw_data_id
string
required
issue_id
string
required

Body

application/json

Body for resolving a single validation issue.

The valid values for a given finding are exactly the ids of the options that finding reports; sending anything else is rejected with the allowed set listed.

resolution
enum<string>
required

The chosen option's id.

Available options:
accept,
reject,
change_cell

Response

Successful Response

A single validation finding for a raw-data file.

Emitted by the parse engine (with no id/timestamps) and persisted to raw_data_issues, where it gains identity and resolution fields.

code
string
required

Stable machine-readable code — an ionworks IssueCode value or an engine-specific code. Branch on this, never on title/detail.

severity
enum<string>
required

Whether this blocks ingestion and how it is displayed.

Available options:
auto_fixed,
warning,
needs_input,
blocking
title
string
required

Plain-English title, no error codes.

options
FixOption · object[]
required
read-only

Choices available for this finding.

Derived from code and severity rather than stored, so the catalogue can grow without a migration and can never drift from what :meth:resolve actually accepts.

id
string | null

Row id once persisted; None for freshly parsed issues.

detail
string
default:""

One-paragraph explanation.

payload
Payload · object

Structured details: columns, observed values, row ranges.

fix_summary
string | null

For auto_fixed issues: short description of what changed.

resolution
enum<string> | null

Reviewer decision; None while unresolved.

Available options:
accept,
reject,
change_cell
resolved_by
string | null

User who resolved it.

resolved_at
string<date-time> | null

Resolution timestamp.