delete_skin_scan

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.

string

required

Format uuid.

string

required

Pattern ^[a-f0-9]{64}$.

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 instead.

"deleted"

required

Description the model receives

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.

Input JSON Schema

{
  "$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
}

Output JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "const": "deleted"
    }
  },
  "required": [
    "status"
  ],
  "additionalProperties": false
}

{
  "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>" }
  }
}

{ "status": "deleted" }

Get started

Concepts

Tools

Data and policy

delete_skin_scan

Input

Output

​Input

​Output

Input

Output