# Save Roles

Save Roles

Endpoint: POST /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

## Response 200 fields (application/json):

  - `retrieveResponse` (object)

  - `retrieveResponse.Name` (string)
    Role Name

  - `retrieveResponse.Status` (string)
    Status

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

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

  - `retrieveResponse.Id` (string)
    Role ID

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

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

  - `retrieveResponse.ParentRoleId` (integer)
    Parent Role ID

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

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

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

  - `retrieveResponse.Description` (string)
    Description

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

  - `retrieveResponse.InternalRole` (integer)
    InternalRole

  - `retrieveResponse.DefaultRole` (string)
    DefaultRole

## Response 400 fields (application/json):

  - `error` (string)
    Bad request

  - `message` (string)
    Bad request

## Response 401 fields (application/json):

  - `error` (string)
    Unauthorized

  - `message` (string)
    Unauthorized

## Response 404 fields (application/json):

  - `error` (string)
    Not found

  - `message` (string)
    Not found

## Response 429 fields (application/json):

  - `error` (string)
    Too many requests

  - `message` (string)
    Too many requests

## Response 500 fields (application/json):

  - `error` (string)
    Internal error

  - `message` (string)
    Internal error