# App

Endpoint: POST app
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: "Google Workspace first observed"

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

  - `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: "App"

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

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

  - `new.type` (string)
    The type of app, formatted as an ENUM value.
    Example: "ZAPIER"

  - `new.approvalStatus` (string,null)
    Approval status of the app, null if not set
    Enum: "UNDER_REVIEW", "APPROVED", "NOT_APPROVED"

  - `new.sensitivityLevel` (string,null)
    The sensitivity level of the app, null if not set
    Enum: "HIGH", "MEDIUM", "LOW"

  - `new.ownerId` (string,null)
    Identifier of the employee who is the owner of this platform
    Example: "87569da6-fb7a-4df7-8ce2-246c14044911"

  - `new.notes` (string)
    Notes recorded on this app (Note - changes to this field do not trigger an UPDATE event)
    Example: "Last security audit: 16 January 2023.\n"

  - `new.creationTimestamp` (integer)
    When the app was first observed, formatted as a UNIX timestamp (in seconds)
    Example: 1698064423

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

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

  - `old.type` (string)
    The type of app, formatted as an ENUM value.
    Example: "ZAPIER"

  - `old.approvalStatus` (string,null)
    Approval status of the app, null if not set
    Enum: "UNDER_REVIEW", "APPROVED", "NOT_APPROVED"

  - `old.sensitivityLevel` (string,null)
    The sensitivity level of the app, null if not set
    Enum: "HIGH", "MEDIUM", "LOW"

  - `old.ownerId` (string,null)
    Identifier of the employee who is the owner of this platform
    Example: "87569da6-fb7a-4df7-8ce2-246c14044911"

  - `old.notes` (string)
    Notes recorded on this app (Note - changes to this field do not trigger an UPDATE event)
    Example: "Last security audit: 16 January 2023.\n"

  - `old.creationTimestamp` (integer)
    When the app was first observed, formatted as a UNIX timestamp (in seconds)
    Example: 1698064423


## Response 2XX fields