Delete a backup
DELETE/v1/points/:id
When the repository keeps deleted backups for a while, or the backup is still locked, the backup is hidden at once, not erased; it is purged no earlier than purge_after, and an operator can bring it back until then. A lock never refuses this delete, only when the backup actually leaves. Otherwise it is erased now, and job_id names the job erasing it. A backup under a legal hold cannot be deleted.
Any member of the project the token is scoped to.
Request
Responses
- 202
- 401
- 403
- 404
- 409
- default
Accepted
Unauthorized.
unauthenticated: The token is missing, expired or not valid.
Forbidden.
forbidden: The token may not delete backups in this project. Or the backup's plan is under a mandatory policy and the token is not an operator's.
Not Found.
not_found: The id is not a UUID, or no backup has it, or it is not visible to this token.
Conflict.
conflict: A legal hold covers the backup, its plan or its project. Or the backup is already deleted. Or its state is not committed, verified, broken or lock_held, for example because it is still being taken or already being erased. Or it was taken in another cloud, where it has to be deleted.
An error, as an RFC 7807 problem document.