Data Import

Revert a data import

Requests the cancellation of a finished import: publishes a data-import-reverted event, which downstream consumers process asynchronously to undo the import (the record's revertedAt / revertedBy reflect a completed revert). Returns 202 Accepted with no body.

Authorization: requires the data_import:import scope and the caller must be an agency owner or an agency admin. The record must belong to the caller's tenant.

Errors: 400 if the record does not exist, was already reverted, or is not finished yet (status other than PROCESSED / FAILED); 403 if the provider does not allow cancellation (cancelAllowed: false) or the caller lacks the scope/role.

post/data-import/{id}/revert

Request

  • Base URL
    https://api.surense.com/api/v1
  • URL
    https://api.surense.com/api/v1/data-import/{id}/revert
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://api.surense.com/oauth/token scopes: data_import:import

Path parameters

idstring uuid required

ID (UUID) of the data import record to revert

Response

The revert was requested and will be processed asynchronously

Changes

No recorded changes to this operation across all 1 revision of this API.