Roles

Delete Roles in User

This endpoint allows you to delete a specific User's Role from the user's ForceManager account database. If the specified User's Role does not exist, the response will be a "bad request". This operation cannot be undone.

You will only be able to delete an User's Role after first providing the Session Key. To know how you can obtain the Session Key, go to Authentication. [ HEADERS

ParameterTypeDescription
Content-Typeapplication/jsonLanguage in which all request and response bodies are encoded
Accept*/*The acceptance
X-Session-KeyAUTH_TOKENThis field must be completed with the token obtained at the authentication
]: <>
</br> **REQUEST**
ParameterTypeDescription
rolesIdObjectArray of the Roles Id that you want to delete for a specific User
</br> **RESPONSE**

Returns a JSON with information with the updated User's Roles.

AttributeTypeDescription
branchesObject, NullBranch to which the User has been assigned
dateCreatedStringDate and time when the User's Role was associated
dateDeletedStringDate and time when the User's Role was deleted
dateUpdatedStringDate and time when the User's Role was udpated
deletedBooleanIf true, the User's Role has been deleted and archived
extIdStringExternal ID of the Role from a third party system (ERP, CRM, Accounting System)
idIntegerThe unique identifier of the Role in ForceManager
levelBooleanIf true, the User is billable. ForceManager charges a fee for the user
nameStringThe Role name
salesRepIdCreatedIntegerUnique identifier of the user who associated the Role
salesRepIdDeletedIntegerUnique identifier of the user who deleted the Role
salesRepIdUpdatedIntegerUnique identifier of the user who updated the Role
</br> **RESPONSE CODES**
StatusDescription
200 OKShows if operation succeeded
400 Bad RequestShows when an invalid request or the requested service is not available
delete/users/{ID}/roles

Request

  • Base URL: https://api.forcemanager.com/api/v4
  • URL: https://api.forcemanager.com/api/v4/users/{ID}/roles
  • Auth: API key in header X-Session-Key

Headers

Acceptstring
X-FM-Entity-Countstring

Response

Delete Roles in User

Changes

No recorded changes to this operation across all 1 revision of this API.