# Browser Extension

Endpoint: POST browser-extension
Version: v1
Security: X-Signature

## Header parameters:

  - `X-Signature` (string, required)
    Example: "X-Signature: t=1492774577,v1=5257a869..."

## Request fields (application/json):

  - `version` (string)
    The version of the event.
    Example: "1"

  - `id` (string)
    The unique identifier for the event. This can be used as an idempotency key.
    Example: "c478966c-f927-411c-b919-179832d3d50c"

  - `timestamp` (integer)
    When the event occurred, formatted as a UNIX timestamp (in seconds).
    Example: 1698604061

  - `type` (string)
    The type of event that occurred.
    Enum: "CREATE", "UPDATE", "DELETE"

  - `category` (string)
    The category of the event.
    Enum: "ENTITY"

  - `description` (string)
    The description of the event. Note: this is subject to change and should not be used to match on this object.
    Example: "Browser extension Privacy Badger installed"

  - `object` (string)
    The object that was created, updated or deleted.
    Enum: "BROWSER_EXTENSION"

  - `friendlyName` (string)
    The friendly name of this object. Note: this is subject to change and should not be used to match on this object.
    Example: "Browser extension"

  - `new` (object)
    This object represents an extension in an employee's browser in your organization.

  - `new.id` (string)
    Static identifier for the extension.
    Example: "gmbgaklkmjakoegficnlkhebmhkjfich"

  - `new.employee` (object)
    This object represents an employee in your organization.

  - `new.employee.id` (string)
    Unique identifier for the employee
    Example: "2a2197de-ad2c-47e4-8dcb-fb0f04cf83e0"

  - `new.employee.email` (string)
    Primary email address of the employee
    Example: "john.hill@example.com"

  - `new.employee.firstName` (string)
    First name of the employee
    Example: "John"

  - `new.employee.lastName` (string)
    Last name of the employee
    Example: "Hill"

  - `new.employee.department` (string)
    Department - as provided by connected API integrations
    Example: "Security Engineering"

  - `new.employee.location` (string)
    Location - as provided by connected API integrations
    Example: "New York"

  - `new.employee.licensed` (boolean)
    Whether the employee is licensed on the Push platform
    Example: true

  - `new.employee.creationTimestamp` (integer)
    When this employee was created, formatted as a UNIX timestamp (in seconds)
    Example: 1698669223

  - `new.employee.chatopsEnabled` (boolean)
    Whether the employee has ChatOps enabledDeprecation notice: this value no longer does anything unless you still have access to the legacy Employee chat topics functionality on your account. It will be removed in the next API version.
    Example: true

  - `new.browserId` (string)
    Identifier of the employee's Push browser.
    Example: "72d0347a-2663-4ef5-b1c5-df39163f1603"

  - `new.name` (string)
    Name of the browser extension
    Example: "Privacy Badger"

  - `new.description` (string)
    Description of the browser extension
    Example: "Privacy Badger automatically learns to block invisible trackers."

  - `new.deploymentMode` (string)
    Which method was used to install this extension
    Enum: "MANAGED", "DEVELOPMENT", "MANUAL", "SIDELOAD", "OTHER"

  - `new.permissions` (array)
    Permissions required by the browser extension
    Example: ["activeTab","contextMenus","storage"]

  - `new.hostPermissions` (array)
    Host permissions allow extensions to interact with the URLs matching these patterns.
    Example: ["https://*/*","http://*/*"]

  - `new.version` (string)
    Version of the browser extension
    Example: "3.1.5.2"

  - `new.versionName` (string)
    Version number shown to the user
    Example: "build rc2"

  - `new.enabled` (boolean)
    Whether the browser extension is enabled or not
    Example: true

  - `new.disabledReason` (string)
    Reason why the browser extension was disabled
    Enum: "NEW_PERMISSION_REQUIRED", "UNKNOWN"

  - `new.updateUrl` (string)
    The URL where the browser extension gets updates from
    Example: "http://clients2.google.com/service/update2/crx"

  - `new.homePageUrl` (string)
    Link to the browser extensions home page
    Example: "http://www.eff.org/"

  - `old` (object)
    This object represents an extension in an employee's browser in your organization.

  - `old.id` (string)
    Static identifier for the extension.
    Example: "gmbgaklkmjakoegficnlkhebmhkjfich"

  - `old.employee` (object)
    This object represents an employee in your organization.

  - `old.employee.id` (string)
    Unique identifier for the employee
    Example: "2a2197de-ad2c-47e4-8dcb-fb0f04cf83e0"

  - `old.employee.email` (string)
    Primary email address of the employee
    Example: "john.hill@example.com"

  - `old.employee.firstName` (string)
    First name of the employee
    Example: "John"

  - `old.employee.lastName` (string)
    Last name of the employee
    Example: "Hill"

  - `old.employee.department` (string)
    Department - as provided by connected API integrations
    Example: "Security Engineering"

  - `old.employee.location` (string)
    Location - as provided by connected API integrations
    Example: "New York"

  - `old.employee.licensed` (boolean)
    Whether the employee is licensed on the Push platform
    Example: true

  - `old.employee.creationTimestamp` (integer)
    When this employee was created, formatted as a UNIX timestamp (in seconds)
    Example: 1698669223

  - `old.employee.chatopsEnabled` (boolean)
    Whether the employee has ChatOps enabledDeprecation notice: this value no longer does anything unless you still have access to the legacy Employee chat topics functionality on your account. It will be removed in the next API version.
    Example: true

  - `old.browserId` (string)
    Identifier of the employee's Push browser.
    Example: "72d0347a-2663-4ef5-b1c5-df39163f1603"

  - `old.name` (string)
    Name of the browser extension
    Example: "Privacy Badger"

  - `old.description` (string)
    Description of the browser extension
    Example: "Privacy Badger automatically learns to block invisible trackers."

  - `old.deploymentMode` (string)
    Which method was used to install this extension
    Enum: "MANAGED", "DEVELOPMENT", "MANUAL", "SIDELOAD", "OTHER"

  - `old.permissions` (array)
    Permissions required by the browser extension
    Example: ["activeTab","contextMenus","storage"]

  - `old.hostPermissions` (array)
    Host permissions allow extensions to interact with the URLs matching these patterns.
    Example: ["https://*/*","http://*/*"]

  - `old.version` (string)
    Version of the browser extension
    Example: "3.1.5.2"

  - `old.versionName` (string)
    Version number shown to the user
    Example: "build rc2"

  - `old.enabled` (boolean)
    Whether the browser extension is enabled or not
    Example: true

  - `old.disabledReason` (string)
    Reason why the browser extension was disabled
    Enum: "NEW_PERMISSION_REQUIRED", "UNKNOWN"

  - `old.updateUrl` (string)
    The URL where the browser extension gets updates from
    Example: "http://clients2.google.com/service/update2/crx"

  - `old.homePageUrl` (string)
    Link to the browser extensions home page
    Example: "http://www.eff.org/"


## Response 2XX fields