Home > API Reference > Document Preparation > Update CheckBox Field

Update CheckBox Field

Business applications can use this service API to update a checkbox field of a document in a package.

Note all of the input parameters can be changed.  Where you wish to retain the current setting submit it in the call unchanged.  You can therefore use the same parameters as when you added the input field, or the information as returned by Get Document Fields.  The latter can be used when a template was applied or the document was created using the GUI interface.

https://api.signinghub.com/v3/packages/{package_id}/documents/{document_id}/fields/checkbox

HTTP Verb

PUT

Authorization

Bearer {access_token}

Content-Type

application/json

Accept

application/json

Response Headers

Request Body

{
   "field_name": "field_name",
    "renamed_as": "Updated field_name",
   "page_no": 1,
   "value": "",
   "validation_rule": "MANDATORY",
   "dimensions": {
      "x": 200,
      "y": 200
   }
}

Status Code

Message

Response Body 

200

OK

403  Forbidden 
{
  "Message": "You are not allowed to perform this action on locked workflow"
}
{
  "Message": "Account is disabled"
}

500

Internal Server Error

{
  "Message": "An internal server error occurred while processing the request"
}

The detail of each item provided in the request and response is provided below:

 Item Details
 Names
 Description
 Request Parameters:
 access_token The access token obtained as a result of successful authentication. If the "scope" parameter was used in authentication request, then this service requires the access token to be obtained using the credentials of an Enterprise admin whose enterprise role has the application integration privileges.

 package_id Package ID to which the document is added.

 document_id The document ID for which the action is to be taken.

 field_name Current name of the field, that is to be updated. 

renamed_as (optional)  Updated name of the field if renaming is intended. 

 page_no Page number on which the field is to be created. 

 value Value of the field.

 validation_rule One or more rules for validation of the fields possible values are "MANDATORY" or "OPTIONAL".

 dimensions > x Left location of the field in pixel.

 dimensions > y Top location of the field in pixel.

 Response Parameters:
 Message The service specific error message returned by the API. This message provides useful information about why the service has returned an error response.






See also
Get Document Fields
Assign Document Field
Add Digital Signature Field
Add Electronic Signature Field
Add In-person Field
Add Initials Field
Add TextBox Field
Add RadioBox Field
Add CheckBox Field
Autoplace Fields
Update Digital Signature Field
Update Electronic Signature Field
Update In-person Field
Update Initials Field
Update TextBox Field
Update RadioBox Field
Delete Document Field