documentIdstring
Document ID (if detecting for a document)
templateIdstring
Template ID (if detecting for a template)
fieldType'signature' | 'initials' | 'date' | 'text' | 'checkbox' | 'dropdown' | 'radio' required
pageNumbernumber required
Page number where field was detected
xPositionnumber required
X position in PDF coordinates
yPositionnumber required
Y position in PDF coordinates
widthnumber required
Field width in PDF coordinates
heightnumber required
Field height in PDF coordinates
confidencenumber required
acroFieldNamestring
Embedded AcroForm field this proposal came from (fillable PDFs). Accepted fields keep the link, so values fill the PDF form field at completion.
acroOptionValuestring
For radio-group AcroForm fields: the option this proposal selects.
optionsstring[]
Allowed values for dropdown fields
maxLengthnumber
Character limit read from the embedded form field (comb boxes)
groupKeystring
Semantic group key (radio options share the AcroForm field name); members are mutually exclusive when accepted
fontSizenumber
Point size the embedded form field draws its value at; absent when the form auto-sizes the text
textColorstring
Text color of the embedded form field, as #rrggbb
textAlign'left' | 'center' | 'right'
Horizontal alignment of the value inside the field box
fontFamilystring
Base font the embedded form field draws its value in
multilineboolean
Whether the embedded form field is multiline
status'pending' | 'accepted' | 'rejected' | 'modified' required
Review status of the proposed field
acceptedFieldIdstring
ID of the accepted field (if accepted)
reviewedAtstring date-time
When the field was reviewed
createdAtstring date-time required
updatedAtstring date-time required