Sign in

v50

latestOpenAPI 3.0.0Commercialraw.githubusercontent.com2022-08-0911645127.8 KB
Organization

Update asset comments

patch/org/assets/{asset_id}/comments

Path parameters

asset_idstring uuid required

UUID of the asset to update

Request body

commentsstring required

Example request

{
  "comments": "Sales Laptop"
}

Response

asset details

idstring uuid required
created_atinteger
updated_atinteger
organization_idstring uuid
site_idstring uuid
aliveboolean
first_seeninteger
last_seeninteger
detected_bystring
typestring
osstring
os_versionstring
hwstring
addressesstring[]
addresses_extrastring[]
macsstring[]
mac_vendorsstring[]
namesstring[]
domainsstring[]
service_countinteger
service_count_tcpinteger
service_count_udpinteger
service_count_arpinteger
service_count_icmpinteger
lowest_ttlinteger
lowest_rttinteger
last_agent_idstring uuid
last_task_idstring uuid
newest_macstring mac
newest_mac_vendorstring
newest_mac_ageinteger
commentsstring
service_ports_tcpstring[]
service_ports_udpstring[]
service_ports_protocolsstring[]
service_ports_productsstring[]
org_namestring
site_namestring
agent_namestring
tagsobject
servicesobject
rttsobject
credentialsobject
attributesobject

Example response

{
  "id": "e77602e0-3fb8-4734-aef9-fbc6fdcb0fa8",
  "created_at": 1576300370,
  "updated_at": 1576300370,
  "organization_id": "e77602e0-3fb8-4734-aef9-fbc6fdcb0fa8",
  "site_id": "e77602e0-3fb8-4734-aef9-fbc6fdcb0fa8",
  "alive": true,
  "first_seen": 1576300370,
  "last_seen": 1576300370,
  "detected_by": "icmp",
  "type": "Server",
  "os": "Ubuntu Linux",
  "hw": "Dell PowerEdge 2500",
  "addresses": [
    "192.168.0.1"
  ],
  "addresses_extra": [
    "192.168.100.1"
  ],
  "macs": [
    "11:22:33:44:55:66"
  ],
  "mac_vendors": [
    "Dell"
  ],
  "names": [
    "www"
  ],
  "domains": [
    "www"
  ],
  "service_count": 10,
  "service_count_tcp": 7,
  "service_count_udp": 1,
  "service_count_arp": 1,
  "service_count_icmp": 1,
  "lowest_rtt": 1,
  "last_agent_id": "e77602e0-3fb8-4734-aef9-fbc6fdcb0fa8",
  "last_task_id": "e77602e0-3fb8-4734-aef9-fbc6fdcb0fa8",
  "newest_mac": "11:22:33:44:55:66",
  "newest_mac_vendor": "Intel Corporate",
  "newest_mac_age": 1304035200000000000,
  "comments": "File Server",
  "service_ports_protocols": [
    "ssh"
  ],
  "service_ports_products": [
    "bind"
  ],
  "org_name": "Test Labs",
  "site_name": "Primary",
  "agent_name": "LAPTOP-F4P1R6"
}