Survey data

Bulk delete submissions status

  curl -X DELETE https://kf.kobotoolbox.org/api/v2/assets/aSAvYreNzVEkrWg5Gdcvg/data/validation_statuses/

Payload

{
  "payload": {
    "submission_ids": [
        1,
        2
      ],
    "validation_status.uid": "validation_status"
  }
}
  • Where: "submissions_ids" (required) is a list of submission root id on the data to delete

The validation status of the submission can be updated. The validation_status.uid should be a string, and it must be one of the following values:

  • validation_status_approved
  • validation_status_not_approved
  • validation_status_on_hold

Response

{
           "detail": "{number_of_submissions} submissions have been updated"
}

Due to limitations with DRF-Spectacular current version, DELETE actions do not support showing a request body OR a response body. This is due to the 'vague' nature of the action which generally does not recommend the use of a payload. To still document this endpoint, example for the payload and response will be included but it will not be possible to test this endpoint. The HTTP code and the errors example are, for their part, factual and can be considered when working with the endpoint.

delete/api/v2/assets/{uid_asset}/data/validation_statuses/

Request

  • The document declares no server URL.
  • Auth: one of:
    • HTTP basic
    • API key in header Authorization

Path parameters

idinteger required

ID of the data (when applicable)

uid_assetstring required

UID of the parent asset

Response

No response body

Changes

No recorded changes to this operation across all 50 revisions of this API.