Delete a specific candidate

DELETE 
/elections/:electionId/candidates/:candidateId

Deletes the requested candidate. The user of the API access token needs access to the linked election. The candidate can only be deleted if the linked election is not frozen.

Request

Responses

204

No Content. The request was successfully executed. The candidate was deleted.

400

Bad Request. The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax, size too large, invalid request message framing, or deceptive request routing). Note, the actual error message may be different from the example one.

401

Unauthorized. The request has not been applied because the user does not have valid authentication credentials for the target resource. Note, the actual error message may be different from the example one.

403

Forbidden. The request contained valid data and was understood by the server, but the server is refusing action. This may be due to the user not having the necessary permissions for a resource or needing an account of some sort, or attempting a prohibited action (e.g. creating a duplicate record where only one is allowed). The request should not be repeated. Note, the actual error message may be different from the example one.

404

Not Found. The requested resource could not be found but may be available in the future. Subsequent requests by the client are permissible. Note, the actual error message may be different from the example one.

406

Not Acceptable. The requested resource is capable of generating only content not acceptable according to the Accept headers sent in the request.

429

Too Many Requests. The user has sent too many requests in a given amount of time.

default

Internal Server Error. A generic error message, given when an unexpected condition was encountered and no more specific message is suitable.