1. Home
  2. Docs
  3. APIs
  4. CrossScan
CrossScanAPI and webhooks

CrossScan reference.

41 endpoints and 27 webhook events. Read from the route handlers, which gives the method and the path but no summary.

68 shown

Webhook events 27

Subscribe to any of these and the product posts to your endpoint when it happens.

  • EVENT asset.discovered New device on the network.
  • EVENT asset.moved Device moved to a different port.
  • EVENT authorization.pending Device awaiting an authorization decision.
  • EVENT authorization.identity_changed Approved address is presenting different hardware.
  • EVENT cadence.window_missed Discovery window closed with no scan.
  • EVENT evidence.sealed Evidence package sealed.
  • EVENT hardware.failed Switch component reported as failed.
  • EVENT network.gateway_discovered Unscanned router named by a switch.
  • EVENT asset.removed Device is no longer on its port.
  • EVENT asset.reidentified Device identifies as different hardware.
  • EVENT port.degrading Port degraded.
  • EVENT port.flapping Port keeps dropping and returning.
  • EVENT port.blocked Spanning tree is blocking a link.
  • EVENT switch.rebooted Switch restarted.
  • EVENT switch.under_load Switch CPU or memory over threshold.
  • EVENT energy.rising Switch power draw climbing.
  • EVENT camera.recording_at_risk Camera is not writing footage.
  • EVENT ups.on_battery UPS is running on battery.
  • EVENT exposure.opened Control interface answers with no password.
  • EVENT exposure.closed Control interface is secured again.
  • EVENT vlan.naming_conflict One VLAN is named differently per switch.
  • EVENT compliance.gap_opened A control that was met stopped being met.
  • EVENT compliance.gap_closed A control is met again.
  • EVENT scan.failed Discovery run did not complete.
  • EVENT integration.failing A system of record stopped answering.
  • EVENT evidence.attested Evidence package attested.
  • EVENT firmware.advisory_matched Advisory matches firmware in this estate.

Access 1 endpoint

  • GET /access

Aggregate 1 endpoint

  • GET /aggregate

Assertions 1 endpoint

  • POST /assertions

Attention 1 endpoint

  • GET /attention

Authorization 1 endpoint

  • GET /authorization

Changes 1 endpoint

  • GET /changes

Compliance 2 endpoints

  • GET /compliance
  • GET /compliance/gaps

Devices 1 endpoint

  • GET /devices/{mac}

Diagnostics 1 endpoint

  • GET /diagnostics

Energy 2 endpoints

  • GET /energy
  • GET /energy/trend

Events 1 endpoint

  • GET /events

Evidence 1 endpoint

  • GET /evidence

Exposures 1 endpoint

  • GET /exposures

Firmware 1 endpoint

  • GET /firmware

Flows 1 endpoint

  • GET /flows

Groupings 1 endpoint

  • GET /groupings

Health 3 endpoints

  • GET /health
  • GET /health/port-history
  • GET /health/port-trends

Integrations 1 endpoint

  • GET /integrations

Inventory 1 endpoint

  • GET /inventory

Match 1 endpoint

  • POST /match

Movement 2 endpoints

  • GET /movement
  • GET /movement/ports

Owners 1 endpoint

  • GET /owners

Ports 1 endpoint

  • GET /ports

Provisioning 1 endpoint

  • GET /provisioning

Reconcile 1 endpoint

  • GET /reconcile

Rooms 1 endpoint

  • GET /rooms

Routes 1 endpoint

  • GET /routes

Scans 1 endpoint

  • GET /scans

Schedules 1 endpoint

  • GET /schedules

Topology 1 endpoint

  • GET /topology

Triage 2 endpoints

  • GET /triage
  • POST /triage

Vlans 1 endpoint

  • GET /vlans

Webhooks 3 endpoints

  • GET /webhooks
  • POST /webhooks
  • DELETE /webhooks/{webhook_id}

Next

This is the reference as published. If something you need is missing, ask instead of guessing at it.