---
title: "Delete a page scan"
method: DELETE
path: "/scans/{id}"
tags: ["Page scans"]
---

# Delete a page scan

`DELETE /scans/{id}`

## Request

- Base URL: `https://www.iminify.com/api/v1`
- URL: `https://www.iminify.com/api/v1/scans/{id}`
- Auth: HTTP bearer

Deletes the scan and every image it produced, with their files, for good. A scan that is still running, or has an image still compressing, is refused.

## Path parameters

- `id` string, uuid, required

## Response `204`

Done. The body is empty.

## Other responses

- `401`: `unauthenticated`: No key was sent, or the key does not exist (it was mistyped or deleted). Send it as `Authorization: Bearer <key>`.
- `403`: `email_not_verified`: The key belongs to an account whose email address is not verified yet. Follow the link in the verification email, then call again with the same key. `account_banned`: The account behind the key has been banned. Its keys stop working with the ban.
- `404`: `not_found`: No image or scan with that id on your account, or no such address. An id from another account answers the same way as one that never existed.
- `409`: `scan_in_progress`: The scan is still running, or one of its images is still being compressed. Wait for everything to finish.
- `429`: `rate_limited`: One of your per-minute limits is spent: requests, compressions or page scans. The compressions and scans are counted together with the website's, so work queued there counts too. Nothing was done; wait for the number of seconds in the `Retry-After` header and send it again.
- `503`: `delete_failed`: The files could not be removed from storage just now, so nothing was deleted. Send the same request again.

---

[API](https://skmtc.dev/iminify/apis/iminify-api.md) · [All operations](https://skmtc.dev/iminify/apis/iminify-api/llms.txt) · [OpenAPI document](https://skmtc.dev/iminify/apis/iminify-api/revisions/12dc614c2c21?raw)