Candidates

Delete a candidate

Changed on

Permanently erases a candidate and all associated data (GDPR cascade). Always asynchronous: returns 202 with a candidates.remove operation to poll. Requires candidates.manage.

delete/candidates/{id}

Request

  • Base URL: https://api.cavuno.com/v1
  • URL: https://api.cavuno.com/v1/candidates/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The candidate id.

Response

Deletion operation accepted.

idstring required

Unique identifier for the object.

object'operation' required

String representing the object's type. Objects of the same type share the same value.

kind'domains.verify' | 'imports.parse' | 'imports.confirm' | 'subscribers.export' | 'subscribers.import' | 'custom_objects.records_import' | 'exports.generate' | 'candidates.remove' | 'employers.remove' required

Operation kind, identifying which workflow the operation runs.

state'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled' required

Current state of the operation.

createdAtstring required

Time at which the operation was created. ISO 8601 datetime.

updatedAtstring required

Time at which the operation was last updated. ISO 8601 datetime.

completedAtstring nullable required

Time at which the operation reached a terminal state, or null if it has not yet completed. ISO 8601 datetime.

cancelRequestedboolean required

Whether cancellation of the operation has been requested.

Changes