Submits an eligibility questionnaire for a contractor employment.

The questionnaire determines if the contractor is eligible for certain products or features. The responses are validated against the JSON schema for the questionnaire type.

Requirements:

• Employment must be of type contractor
• Employment must be in created status
• Responses must conform to the questionnaire JSON schema

Authentication

This endpoint accepts any one of the following token types:

• Company-scoped access token (OAuth2AuthorizationCode) — obtained by a company manager through the Authorization Code flow or the Refresh Token flow. See Authentication for partners.
• Company-scoped access token (assertion) (OAuth2CompanyManagerAssertion) — obtained through the urn:ietf:params:oauth:grant-type:jwt-bearer grant for a company manager. See OAuth Assertion.
• Customer API token (CustomerAPIToken) — generated by the customer on their Integration Settings page, with the scopes they choose there. See Authorization for customers.

Scopes

Any one of the scopes in a token type's row is enough. all:write works too.

{
  "employment_slug": "fd32b683-a94a-4496-a0c4-726c088af483",
  "responses": {
    "question_key1": "yes",
    "question_key2": "no"
  },
  "type": "contractor_of_record"
}

{
  "data": {
    "is_blocking": true,
    "questions": {
      "question_key1": "This is the label of the question",
      "question_key2": "This is another question label"
    },
    "responses": {
      "question_key1": "yes",
      "question_key2": "no"
    },
    "slug": "fd32b683-a94a-4496-a0c4-726c088af483",
    "submitted_at": "2021-07-15T18:18:17",
    "type": "contractor_of_record"
  }
}