Questionnaire request

Move an answer request to a new status

Drives the whole review lifecycle of a single answer request: the answering company submits with IN_REVIEW, and the questionnaire's owner starts the review, asks for changes or marks it complete. Only the owner may set anything other than IN_REVIEW; anyone who is neither the owner nor the company being asked gets 404 rather than 403, so the endpoint never confirms a request they cannot see. Submitting for review is refused with 422 while a compulsory question is unanswered — a check that applies to the answering company, not the owner. IN_REVIEW also moves every answer that has not already been approved or denied into review, and COMPLETED approves whatever is still under review. The answering or requesting company is notified by email depending on the direction of the move, and the questionnaire's progress statistics are recomputed asynchronously.

patch/api/questionnaires/{id}/requests/{requestId}/status

Path parameters

idstring required
requestIdstring required

Request body

status'OPEN' | 'IN_REVIEW' | 'COMPLETED' | 'REQUEST_CHANGES' | 'DELETED' required

Response

Default Response

Changes

Changed in 2 of the 49 revisions of this API.1022

  • 97e51f27dc771021See the full diff
    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the response property / became nullable for the status

      response-property-became-nullable

    • ▲

      the / response's property type changed from no type to object for status

      response-property-type-changed

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      removed subschema #1 subschema #2 from the / response property anyOf list for the response status

      response-property-any-of-removed

    • ○

      response property data/createdByCompanyId list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • ○

      response property data/forCompanyId list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • ○

      response property data/isRemoved list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • ○

      response property data/onBehalfOfCompanyId list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • ○

      response property data/questionnaireName list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • ○

      response property data/status list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • ○

      response property data/updatedByUserId list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • ○

      response property data/updatedByUserName list-of-types was narrowed by removing types null from media type application/json of response 200

      response-property-list-of-types-narrowed

    • ○

      endpoint added

      endpoint-added

Of the 49 revisions, 1 has no diff computed.