# Upsert Roles

Upsert Roles

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

## Header parameters:

  - `sessionId` (string, required)

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

  - `brmObjects` (object)

  - `brmObjects.Name` (string, required)
    Role Name

  - `brmObjects.Status` (string)
    Status

  - `brmObjects.CreditApprovalThreshold` (integer)
    Credit Approval Threshold

  - `brmObjects.AllowProcessOnOff` (integer)
    Allow Process On/Off

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

  - `brmObjects.CreditAutoApprovalLimit` (string)
    Credit Auto Approval Limit

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

  - `brmObjects.ParentRoleId` (integer, required)
    Parent Role ID

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

  - `brmObjects.CustomerPortalRole` (integer)
    Customer Portal Role: Roles with this property checked are used exclusively for the users of customer portal

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

  - `brmObjects.Description` (string)
    Description

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

  - `brmObjects.InternalRole` (integer)
    InternalRole

  - `brmObjects.DefaultRole` (string)
    DefaultRole

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

## Response 200 fields (application/json):

  - `upsertResponse` (array)

  - `upsertResponse.Id` (integer)

  - `upsertResponse.success` (boolean)

  - `upsertResponse.ErrorText` (string)

  - `upsertResponse.ErrorElementField` (string)

  - `upsertResponse.created` (boolean)