Skip to main content
PUT
/
v1
/
monitoring
/
arps
/
{siteId}
/
{arpEntryId}
Update ARP Entry
curl --request PUT \
  --url https://api.altostrat.io/v1/monitoring/arps/{siteId}/{arpEntryId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "group": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "alias": "Living Room TV"
}'
{
  "id": "0c8526584284b025f3c328904724cf48a1a3848b",
  "mac": "00:1A:2B:3C:4D:5E",
  "ip_address": "192.168.88.254",
  "interface": "bridge",
  "last_seen": "5 minutes ago",
  "group": "<string>",
  "hostname": "my-laptop.local",
  "manufacturer": "Apple, Inc.",
  "site_id": "d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8",
  "range": "192.168.88.0/24",
  "alias": "Main Server",
  "serial": "<string>"
}

Authorizations

โ€‹
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

โ€‹
siteId
string<uuid>
required

The unique identifier for the site.

Example:

"d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8"

โ€‹
arpEntryId
string
required

The unique identifier for the ARP entry (a SHA1 hash of site ID and MAC address).

Example:

"0c8526584284b025f3c328904724cf48a1a3848b"

Body

application/json
โ€‹
group
string<uuid> | null

The UUID of an existing ARP group to assign this entry to.

โ€‹
alias
string | null

A custom, human-readable name for the device.

Example:

"Living Room TV"

Response

The updated ARP entry object.

โ€‹
id
string

The unique identifier for the ARP entry (a SHA1 hash of site ID and MAC address).

Example:

"0c8526584284b025f3c328904724cf48a1a3848b"

โ€‹
mac
string

The MAC address of the device.

Example:

"00:1A:2B:3C:4D:5E"

โ€‹
ip_address
string<ipv4>

The IP address of the device.

Example:

"192.168.88.254"

โ€‹
interface
string

The network interface on which the device was seen.

Example:

"bridge"

โ€‹
last_seen
string

Human-readable string indicating when the device was last seen.

Example:

"5 minutes ago"

โ€‹
group
string | null

The ARP group this device belongs to, if any.

โ€‹
hostname
string

The device's hostname, if discovered.

Example:

"my-laptop.local"

โ€‹
manufacturer
string

The manufacturer of the device, derived from the MAC address.

Example:

"Apple, Inc."

โ€‹
site_id
string<uuid>

The site where this device was discovered.

Example:

"d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8"

โ€‹
range
string | null

The IP subnet range the device belongs to.

Example:

"192.168.88.0/24"

โ€‹
alias
string | null

A user-defined alias for the device.

Example:

"Main Server"

โ€‹
serial
string | null

The serial number of the device, if discovered via SNMP.