SitesMarvis Configs

searchSiteMarvisConfigActions

GET
/api/v1/sites/{site_id}/marvis_configs/search

Search Marvis Config Actions for a site.

Authorization

Authorization<token>

Preferred authentication method for automation and integrations. Send the API token in the HTTP Authorization header.

Format: Authorization: Token {apitoken}

Notes:

  • An API token generated for a specific admin has the same privileges as that admin
  • An API token is automatically removed if it is not used for more than 90 days
  • SSO admins cannot generate admin API tokens. Use organization API tokens when scoped Org/Site privileges are needed.

In: header

Path Parameters

site_id*string
Formatuuid

Query Parameters

mac?string

Filter by device MAC address

type?string

Filter by config type (e.g. wired)

src?string

Filter by source of the config action (e.g. marvis)

admin_id?string

Filter by admin ID

op?string

Filter by operation type (e.g. disable_port, enable_port, update_mtu, add_vlans_to_port)

port_id?string

Filter by port identifier (e.g. ge-0/0/13)

vlan_ids?integer

Filter by VLAN ID

reason?string

Filter by reason for the config action (e.g. rogue_dhcp_server_detected)

limit?integer

Maximum number of results to return per page

Range0 <= value
Default100
start?string

Lower bound of the time range, as an epoch timestamp in seconds or a relative value such as -1d or -1w

end?string

Upper bound of the time range, as an epoch timestamp in seconds or a relative value such as -1d, -2h, or now

duration?string

Time range duration for the query, using relative units such as 10m, 7d, or 2w

Default"1d"

Response Body

curl -X GET "https://example.com/api/v1/sites/000000ab-00ab-00ab-00ab-0000000000ab/marvis_configs/search"
{  "end": 1775122221,  "limit": 10,  "results": [    {      "admin_id": "6d617276-0000-0000-3157-000000000000",      "id": "05b46288-37d4-4860-9de4-1edc6e8d5363",      "mac": "f8c1165aba00",      "op": "disable_port",      "org_id": "174260d5-cb22-4ea8-badb-c77a89acb0a9",      "port_id": "ge-0/0/2",      "reason": "rogue_dhcp_server_detected",      "site_id": "437ac5f0-fc76-4a2b-87ab-d8d1e5c00405",      "src": "marvis",      "timestamp": 1775028130.405962,      "type": "wired",      "vlan_ids": []    },    {      "admin_id": "6d617276-0000-0000-3157-000000000000",      "id": "b1a81ed4-a7a2-4945-b01d-f54afe6d5cc4",      "mac": "f8c1165aba00",      "op": "add_vlans_to_port",      "org_id": "174260d5-cb22-4ea8-badb-c77a89acb0a9",      "port_id": "ge-0/0/12",      "reason": "missing_vlans",      "site_id": "437ac5f0-fc76-4a2b-87ab-d8d1e5c00405",      "src": "marvis",      "timestamp": 1774866716.15723,      "type": "wired",      "vlan_ids": [        100,        200      ]    }  ],  "start": 1775118621,  "total": 2}