Action Items

For the application workflow API, Action Items can be one of five types:

  1. Notes
  2. Prescreening Questions
  3. Disclaimers
  4. Compliance Questions
  5. Attachments

Valid object structures for these types is outlined below:

Note

Represents a Note Action Item in the Application Workflow

FieldContent TypeDescription
titlestringTitle of the Note
instructionsstringInstructions for the note.
notesstringText content of the note.
typestringIndicates the type of action item. Should always equal Note
pageNumberintegerIndicates the page number where the action item is located
displayOrderintegerIndicates the display sequence order among all the action items.

Prescreening or Compliance

Represents a Prescreening question Action Item in the Application Workflow

FieldContent TypeDescription
idstringThe unique identifier for the question.
instructionsstringInstructions for the question.
questionTextstringText of the question.
responseTypestringIndicates response type for the question. Valid options are: MultipleChoiceSingleAnswer, MultipleChoiceMultipleAnswer, Text, Date, Numeric, TitleAndInstructions, Boolean, File, FileOrPlainText
requiredbooleanIndicates if the question is required or not.
responseOptionsresponseOptions ArrayCollection of response options for this question. This is available only when response type is MultipleChoiceSingleAnswer, MultipleChoiceMultiAnswer, TrueFalse, YesNo.
typestringIndicates the type of action item. Should always equal Prescreening or Compliance
pageNumberintegerIndicates the page number where the action item is located
displayOrderintegerIndicates the display sequence order among all the action items.

Disclaimer

Represents a Disclaimer Action Item in the Application Workflow.

FieldContent TypeDescription
agreementRequiredbooleanIndicates if agreement from the candidate is required. If true, the user must agree to this disclaimer.
messageWhenDisagreestringMessage to display when the candidate does not agree to this disclaimer.
idstringThe unique identifier for the disclaimer.
instructionsstringInstructions for the question.
questionTextstringText of the question.
responseTypestringIndicates response type for the disclaimer. Valid options are: MultipleChoiceSingleAnswer, MultipleChoiceMultipleAnswer, Text, Date, Numeric, TitleAndInstructions, Boolean, File, FileOrPlainText
requiredbooleanIndicates if the question is required or not.
responseOptionsresponseOptions ArrayCollection of response options for this question. This is available only when response type is MultipleChoiceSingleAnswer, MultipleChoiceMultiAnswer, TrueFalse, YesNo.
typestringIndicates the type of action item. Should always equal Disclaimer
pageNumberintegerIndicates the page number where the action item is located
displayOrderintegerIndicates the display sequence order among all the action items.

Resume or CoverLetter or AdditionalAttachment

Represents any item in the Application workflow where a file must be attached.

FieldContent TypeDescription
titlestringTitle of the attachment.
instructionsstringInstructions for the attachment.
responseTypestringIndicates response type for the disclaimer. Valid options are: MultipleChoiceSingleAnswer, MultipleChoiceMultipleAnswer, Text, Date, Numeric, TitleAndInstructions, Boolean, File, FileOrPlainText
requiredbooleanIndicates if attachment is required or not.
typestringIndicates the type of action item. Should always equal Resume, CoverLetter, or AdditionalAttachment
pageNumberintegerIndicates the page number where the action item is located
displayOrderintegerIndicates the display sequence order among all the action items.