> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skinai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# delete_skin_scan

> Delete a guest scan and revoke its token.

Revokes the scan's `access_token` immediately and schedules cleanup of the scan at the analysis provider. Call it only when the person asks. Deletion has its own rate-limit budget, so it keeps working when other calls are limited. A result the person saved to their Skan account is not affected.

A second call, or any later call with the same token, returns `not_found`.

|             |                                                                     |
| ----------- | ------------------------------------------------------------------- |
| Tool        | `delete_skin_scan`                                                  |
| Listed on   | `/mcp` (guest) and `/mcp/account` (OAuth)                           |
| Annotations | `readOnlyHint: false` `destructiveHint: true` `openWorldHint: true` |

## Input

Sent as `params.arguments` of `tools/call`. Unknown keys are rejected with `invalid_input`.

<ParamField body="run_id" type="string" required>
  Format `uuid`.
</ParamField>

<ParamField body="access_token" type="string" required>
  Pattern `^[a-f0-9]{64}$`.
</ParamField>

## Output

Returned as `structuredContent`, and as the same object serialised in `content[0].text`. On failure the result has `isError: true` and an [error body](/errors) instead.

<ResponseField name="status" type="&#x22;deleted&#x22;" required />

<AccordionGroup>
  <Accordion title="Description the model receives">
    ```text theme={null}
    Delete this guest scan after the person asks. Immediately revokes guest access and schedules provider/photo cleanup. Does not delete a result previously saved to a Skan account.
    ```
  </Accordion>

  <Accordion title="Input JSON Schema">
    ```json theme={null}
    {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "type": "object",
      "properties": {
        "run_id": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "access_token": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        }
      },
      "required": [
        "run_id",
        "access_token"
      ],
      "additionalProperties": false
    }
    ```
  </Accordion>

  <Accordion title="Output JSON Schema">
    ```json theme={null}
    {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "const": "deleted"
        }
      },
      "required": [
        "status"
      ],
      "additionalProperties": false
    }
    ```
  </Accordion>
</AccordionGroup>

<RequestExample>
  ```json Request theme={null}
  {
    "jsonrpc": "2.0", "id": 3, "method": "tools/call",
    "params": {
      "name": "delete_skin_scan",
      "arguments": { "run_id": "db56607f-edeb-47f3-bc5d-812d7af19adb", "access_token": "<access_token>" }
    }
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response (structuredContent) theme={null}
  { "status": "deleted" }
  ```
</ResponseExample>