Skip to main content
PUT
/
metrics
/
arps
/
{siteId}
/
{arpEntryId}
Update ARP Entry
curl --request PUT \
  --url https://v1.api.altostrat.io/metrics/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>"
}

Documentation Index

Fetch the complete documentation index at: https://altostrat.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.