---
title: "Non-Blocking Trigger Live Scan"
method: POST
path: "/api/v1/livescan/{scannerId}/task/"
tags: ["Live Scanning"]
---

# Non-Blocking Trigger Live Scan

`POST /api/v1/livescan/{scannerId}/task/`

Task a URL to be scanned. The HTTP request will return with the scan UUID immediately and then it is your responsibility to poll the result resource type until the scan has finished.

## Path parameters

- `scannerId` string, required

## Request body

- LivescanRequest
  - `task` object, required
    - `url` string, uri, required — URL to scan
    - `visibility` 'public' | 'unlisted' | 'private'
    - `tags` string[] — User-defined tags to annotate this scan, e.g. "phishing" or "malicious".
  - `scanner` object
    - `pageTimeout` integer — Time to wait for the whole scan process (in ms)
    - `captureDelay` integer — Delay after page has finished loading before capturing page content
    - `extraHeaders` object — Extra Key-Value headers to send via the HTTP headers
    - `enableFeatures` string[]
    - `disableFeatures` string[]

## Response `200`

OK

- object
  - `uuid` string, uuid — UUID of scan

---

[API](https://skmtc.net/urlscan/apis/urlscan-io-apis.md) · [All operations](https://skmtc.net/urlscan/apis/urlscan-io-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/urlscan/urlscan-io-apis/versions/5d97b31afd68/schema)