Skip to navigation
API ReferenceCorrection ProposalsSubmit correction

Submit correction

Submit for human review; never changes published data directly. JSON body maximum 16 KB. Account caps: 100 open proposals and 50 submissions per rolling day. Same normalized proposal and key replay the original receipt with 200; different content returns 409. Requires corrections:submit.

Authentication

AuthorizationBearer

Create a scoped key at https://app.defdex.io/developer/keys. Keep it private.

Headers

Idempotency-KeystringRequiredformat: "^[A-Za-z0-9._:-]+$"16-128 characters

Request

This endpoint expects an object.
datasetenumRequired
record_idstringRequired1-12000 characters
explanationstringRequired1-5000 characters
sourceslist of stringsRequired
proposed_valueanyOptional

Proposed JSON; fields ending _usd require decimal strings. Maximum nesting 32; no unsafe integers.

Response headers

X-Request-IdstringOptional
Support identifier on admitted requests.

Response

Success
idstringOptional
datasetstringOptional
record_idstringOptional
explanationstringOptional
created_atstringOptional
updated_atstringOptional
statusenumOptional
Allowed values:
reviewer_notestring or nullOptional
sourceslist of stringsOptional
proposed_valueanyOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
413
Content Too Large Error
429
Too Many Requests Error
503
Service Unavailable Error