---
title: "Scan network"
method: POST
path: "/arrow-clients/{uuid}/scan-network/"
tags: ["arrow-clients"]
---

# Scan network

`POST /arrow-clients/{uuid}/scan-network/`

## Request

- Base URL: `https://api.angelcam.com/v1`
- URL: `https://api.angelcam.com/v1/arrow-clients/{uuid}/scan-network/`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://my.angelcam.com/oauth/authorize/`, token URL `https://my.angelcam.com/oauth/token/`
    - Password, token URL `https://api.angelcam.com/oauth/token/`
    - Scopes: `arrow_client_manage`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/angelcam/apis/angelcam-api/docs/arrow-clients/:uuid/scan-network/post.ts> (a function with typed inputs; its response is checked against the schema)

Trigger a scan of the local network that the Arrow client is connected to. The scan discovers cameras and other services available on that network.

The scan runs asynchronously — this endpoint returns immediately. To check whether the scan is still in progress, poll the [Arrow client detail](#tag/arrow-clients/GET/arrow-clients/{uuid}/) endpoint and inspect the `scanning` field. Discovered services appear in the [Arrow client services](#tag/arrow-clients/GET/arrow-clients/{uuid}/services/) list once the scan completes.

The API responds with 502 Bad Gateway if the Arrow client is offline or unreachable.

## Path parameters

- `uuid` string, uuid, required

## Response `204`

Empty response.

## Other responses

- `401`: Missing or invalid authorization.
- `403`: Missing permission.
- `404`: The specified resource was not found
- `502`: Unable to contact the target gateway.

---

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