# Upsert Buttons and Actions

Upsert Buttons and Actions

Endpoint: PATCH /rest/2.0/ENTITY_WIDGET
Version: 1.0
Security: JWT

## Header parameters:

  - `sessionId` (string, required)

## Request fields (application/json; charset=utf-8):

  - `brmObjects` (object)

  - `brmObjects.OverrideExtensionWidget` (integer)
    Override Widget

  - `brmObjects.FullPageFlag` (integer)
    Full Page

  - `brmObjects.DisplayType` (string)
    Display Type

  - `brmObjects.Created` (string)
    System controlled field: Date and time the record was created

  - `brmObjects.CreatedUserId` (string)
    System controlled field: Id of the user that created the record

  - `brmObjects.SystemFlag` (integer)
    System Widget

  - `brmObjects.EnabledFlag` (integer)
    Enabled

  - `brmObjects.UpdatedUserId` (string)
    System controlled field: Id of the last user that updated the record

  - `brmObjects.EditorURL` (string)
    Editor

  - `brmObjects.ExtensionWidget` (integer)
    Extension Widget

  - `brmObjects.EntityWidgetName` (string)
    Name

  - `brmObjects.Updated` (string)
    System controlled field: Date and time the record was last updated

  - `brmObjects.OverridePageWidget` (integer)
    Override Page

  - `brmObjects.ContentSource` (string)
    Content Source

  - `brmObjects.PageWidget` (integer)
    Page Widget

  - `brmObjects.WidgetTypeId` (string)
    Widget Type

  - `brmObjects.WizardId` (integer)
    Wizard

  - `brmObjects.Id` (string, required)
    ID

  - `brmObjects.DisplayUpdate` (integer)
    Display Update

  - `brmObjects.DisplayView` (integer)
    Display View

  - `brmObjects.DisplayList` (integer)
    Display List

  - `brmObjects.Label` (string)
    Label

  - `brmObjects.Description` (string)
    Description

  - `brmObjects.FilterLogic` (string)
    FilterLogic

  - `brmObjects.ExternalKey` (string, required)
    ExternalKey

  - `brmObjects.EntityId` (integer, required)
    EntityId

  - `brmObjects.LabelId` (string)
    LabelId

  - `brmObjects.DisplayNew` (integer)
    Display New

  - `externalIDFieldName` (string)
    Enum: "ExternalKey"

## Response 200 fields (application/json):

  - `upsertResponse` (array)

  - `upsertResponse.Id` (integer)

  - `upsertResponse.success` (boolean)

  - `upsertResponse.ErrorText` (string)

  - `upsertResponse.ErrorElementField` (string)

  - `upsertResponse.created` (boolean)