Skip to main content
PUT
/
devices
/
{macAddress}
Update Device Alias
curl --request PUT \
  --url https://api.altostrat.io/arp/devices/{macAddress} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "alias": "<string>"
}'
{
  "mac_address": "00:1A:2B:3C:4D:5E",
  "hostname": "my-laptop.lan",
  "alias": "John's Work Laptop",
  "manufacturer": "Apple, Inc.",
  "site_id": "9c148cc3-a628-440e-b9be-af654a2ac8e8",
  "current_ip": {
    "ip_address": "192.168.1.100",
    "interface": "ether2",
    "first_seen_at": "2025-04-08T10:00:00Z",
    "last_seen_at": "2025-04-08T14:20:30Z"
  },
  "first_seen_at": "2025-03-10T08:00:00Z",
  "last_seen_at": "2025-04-08T14:20:30Z"
}

Authorizations

​
Authorization
string
header
required

Enter the Bearer token (obtained via authentication or provided internally).

Path Parameters

​
macAddress
string
required

MAC address of the device

Body

application/json
​
alias
string
required

The user-defined alias for the device.

Maximum length: 255

Response

Device alias updated successfully.

​
mac_address
string
Example:

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

​
hostname
string | null
Example:

"my-laptop.lan"

​
alias
string | null
Example:

"John's Work Laptop"

​
manufacturer
string | null
Example:

"Apple, Inc."

​
site_id
string<uuid>
Example:

"9c148cc3-a628-440e-b9be-af654a2ac8e8"

​
current_ip
object
​
first_seen_at
string<date-time>

Timestamp when the device was first recorded.

Example:

"2025-03-10T08:00:00Z"

​
last_seen_at
string<date-time>

Timestamp when the device was last seen in an ARP sync.

Example:

"2025-04-08T14:20:30Z"

⌘I