# Trigger a LAN scan from this edge (/docs/api-reference/edges/EdgesController_startScan)

`POST /api/edges/{id}/scan`

Base URL: https://api.xentr.ai

Authentication: bearer token (`Authorization: Bearer <token>`).

Kicks off an asynchronous scan job. The edge receives the command via MQTT and streams hits back. Use GET /api/edges/:id/scan/:job_id to poll results.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `id` | path | yes | string | Edge UUID |
| `organizationId` | query | yes | string |  |

## Request body

Required.

Content type: `application/json`

```json
{
  "type": "object",
  "properties": {
    "subnet": {
      "type": "string",
      "description": "CIDR subnet to scan. Defaults to the /24 containing the edge's own IP.",
      "example": "192.168.1.0/24"
    }
  }
}
```

## Responses

### 201: Scan job created