API ReferenceDocument Insights

Submit extraction feedback

Submits feedback on an extraction result. Feedback is surfaced to the team that configures your workspace and is used to improve extraction quality. Reference a specific field with fieldId, or omit it for feedback on the whole extraction.

Authentication

Authorizationstring

Use the API key format: api-key <token>.

Path parameters

extractionIdstringRequired
Extraction identifier returned when the extraction was created.

Request

This endpoint expects an object.
messagestringRequired1-1024 characters

Human-readable feedback message. Maximum length: 1024 characters.

typeenumOptional

Feedback type. ERROR marks the extraction as needing correction and review. INFO records a note without marking the extraction as incorrect. Defaults to ERROR when omitted.

fieldIdstringOptional1-256 characters

Optional extracted field identifier. Include it when feedback applies to a specific field from output.fields; omit it for general extraction feedback.

Response

Feedback recorded.
idstring
Feedback identifier.
extractionIdstring
The extraction this feedback belongs to.
messagestring
The submitted feedback text.
typeenum
Feedback type accepted by Document Insights.
fieldIdstring or null
The field identifier supplied in the request. Returned as null for general extraction feedback.
createdAtdatetime
UTC timestamp when the feedback was accepted.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
405
Method Not Allowed Error
406
Not Acceptable Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
502
Bad Gateway Error