Skip to content

client.browser_extension

Access browser extension inventory and permission metadata.

Property

client.browser_extension

Methods

  • get_all() -> BrowserExtensionResults: fetch the JSON-backed browser extension inventory.
  • get_all_files() -> BrowserExtensionResults: fetch the via-files browser extension inventory.
  • permissionsinfo(query: BrowserExtensionsPermissionsInfoQuery | None = None) -> BrowserExtensionsPermissionsInfoResults: fetch permission metadata for browser extensions.

Notes

  • get_all() and get_all_files() expose the same results-wrapper interface.
  • get_all_files() delegates to the machine endpoint's export-backed implementation.
  • Use permissionsinfo() when you need extension permission metadata rather than per-machine inventory rows.

API

Microsoft Defender for Endpoint browser-extension inventory endpoint.

This module defines: - BrowserExtensionsPermissionsInfoQuery: OData query model for filtering browser extension permission records. - BrowserExtensionResults and BrowserExtensionsResults: lazy result wrappers mapped to the browser-extension Arrow schemas. - BrowserExtensionEndpoint: a thin shim that forwards requests to the browser-extension paths on the Machines API and returns correctly-typed result wrappers. Core HTTP and pagination logic is inherited from MachinesEndpoint / BaseEndpoint.

Endpoint methods return lazy BaseResults subclasses and defer HTTP requests until a terminal materialization method is called.

Docs: https://learn.microsoft.com/en-us/defender-endpoint/api/export-browser-extensions-assessment

BrowserExtensionsPermissionsInfoQuery

OData query parameters for the api/browserExtensions/permissionsinfo endpoint.

BrowserExtensionResults

BrowserExtensionResults(
    endpoint: BaseEndpoint,
    params: dict[str, str],
    *,
    path: str | None = None,
    single: bool = False,
    files: bool = False,
    method: str = "GET",
    request_kwargs: dict[str, Any] | None = None,
    use_concurrent_skip_pagination: bool | None = None,
    skip_page_size: int | None = None,
    skip_max_concurrent: int | None = None,
)

Results from the /api/machines/BrowserExtensionsInventoryByMachine endpoint.

BrowserExtensionsPermissionsInfoResults

BrowserExtensionsPermissionsInfoResults(
    endpoint: BaseEndpoint,
    params: dict[str, str],
    *,
    path: str | None = None,
    single: bool = False,
    files: bool = False,
    method: str = "GET",
    request_kwargs: dict[str, Any] | None = None,
    use_concurrent_skip_pagination: bool | None = None,
    skip_page_size: int | None = None,
    skip_max_concurrent: int | None = None,
)

Results from the /api/browserExtensions/permissionsinfo endpoint.

BrowserExtensionEndpoint

BrowserExtensionEndpoint(http: Client, auth: MSALAuth)

Client for browser extension inventory endpoints.

get_all

Get All Browser Extensions for a machine.

Docs: - https://learn.microsoft.com/en-us/defender-endpoint/api/get-assessment-browser-extensions - https://learn.microsoft.com/en-us/defender-endpoint/api/get-assessment-browser-extensions#1-export-browser-extensions-assessment-json-response

get_all_files

get_all_files() -> BrowserExtensionResults

Get All Browser Extensions for a machine.

Same Results as get_all but exported as a file instead of in the response body. Recommended for larger data sets, as it returns zipped files with the data instead of returning it in the response body.

Docs: - https://learn.microsoft.com/en-us/defender-endpoint/api/get-assessment-browser-extensions - https://learn.microsoft.com/en-us/defender-endpoint/api/get-assessment-browser-extensions#2-export-browser-extension-assessment-via-files

permissionsinfo

Get permissions info for browser extensions.

Docs: - https://learn.microsoft.com/en-us/defender-endpoint/api/get-browser-extensions-permission-info