REST interface for BPD-related resources - User Details Resource - GET Method

Retrieve information about a user that has been defined to the IBM BPM installation. To retrieve details about the current user, omit both the userName and userID parameters.

Sample method invocation

GET /rest/bpm/wle/v1/user[?userID={string}][&userName={string}][&includeInternalMemberships={boolean}][&groups={string}][&parts={string}][&refreshUser={boolean}][&includeEditableUserPreferences={boolean}]

Parameters

Optional parameters
NameValue TypeDescription
userID string
A value representing the userID of the user you are interested in.
userName string
A value representing the userName of the user you are interested in.
includeInternalMemberships boolean
If this parameter is set to true, the returned list of memberships includes the internal group membership names that the user belongs to. The default value is true.
groups string
One or more groups for which membership is to be evaluated. A comma-separated list can be used to specify several group names.
parts string
A string indicating which parts of the response data should be returned. You can use the following values: memberships, all (the default), or none.
refreshUser boolean
Refreshes full-name and group memberships of users before retrieving them. Only members of the group that are referred to by the "ACTION_REFRESH_USER" action policy can use this function. 2016.09: The refresh also synchronizes the state of the users in the BPM database with the user availability in the user registry. Users that were deleted from the user registry do not become inactive in the BPM database. Users that are reactivated in the user registry become active in the BPM database.
includeEditableUserPreferences boolean
2017.03: Set this property to true to include the list of user preferences that the user is allowed to manage. The default value is false.

Request content

None

Response content

User - the details associated with a user defined to the IBM BPM installation (User complexType). Non-privileged users only retrieve the user attributes that are explicitly listed as public attributes. In queries for data about the current user, public attributes and self-manageable attributes are returned. The users who are authorized in ACTION_MANAGE_ANY_USERATTRIBUTE can see all user attribute values.

The default content type is application/json.

MIME type: application/json


+ View schema
{  "description": "User", 
   "type": "object",
   "properties":
   {  
      "userID": {"type": "integer",
         "description": "The user ID of the user that is described by this object."
      },
      "userName": {"type": "string",
         "description": "The user name of the user that is described by this object.",
      },
      "fullName": {"type": "string",
         "description": "The full name of the user that is described by this object.",
      },
      "isDisabled": {"type": "boolean",
         "description": "Indicates whether this user is disabled."
      },
      "primaryGroup": {"type": "string",
         "description": "The primary group associated with this user."
      },
      "emailAddress": {"type": "string",
         "description": "The email address associated with this user."
      },
      "userPreferences":
      [
         {
            "key" : { "type": "string",
               "description": "The key associated with the user preference."
            },
            "value" : { "type": "string",
               "description": "They value associated with the user preference."
            }
         }
      ],
      "editableUserPreferences": {"type": "[string]",
         "description": "List of user preferences the user is allowed to manage."
      },
      "memberships": {"type": "[string]",
         "description": "List of groups in which the user is a member."
      }
   }
}
+ View example content
{
   "status":"200",
   "data":{
      "userID":1,
      "userName":"tw_admin",
      "fullName":"Internal TW Admin user",
      "isDisabled":false,
      "primaryGroup":null,
      "emailAddress":null,
      "userPreferences":{
         "Locale":"en"
      },
      "editableUserPreferences":[
         "Alert On Assign And Run",
         "Base Text Direction",
         "Calendar Type",
         "Federated Portal Dashboard Display Order",
         "Image",
         "Locale",
         "Phone Number",
         "Portal Dashboard Display Order",
         "Portal Default Page",
         "Portal Mention Timestamp",
         "Portal Notification New Task To Me",
         "Portal Notification New Task To My Group",
         "Portal Notification On Activity Change",
         "Portal Notification Post Mention",
         "Portal Open Task In New Window",
         "Portal Task List View",
         "Primary Role",
         "Send Connections Notification On New Task",
         "Show Unfollow Messages",
         "Task Email Address",
         "Task Notification",
         "Title"
      ],
      "tasksCollaboration":["75"],
      "memberships":[
         "Debug",
         "tw_admins",
         "tw_authors",
         "tw_portal_admins",
         "tw_process_owners",
         "tw_allusers",
         "All Users_T_da7e4d23-78cb-4483-98ed-b9c238308a03.40551a86-bac6-474e-a666-85f9a8a83426",
         "All Users_S_da7e4d23-78cb-4483-98ed-b9c238308a03.40551a86-bac6-474e-a666-85f9a8a83426",
         "All Users_T_da7e4d23-78cb-4483-98ed-b9c238308a03.36c07d6c-ad75-4a42-9675-95275f281c3f",
         "Process Owner_T_9a9f919e-6644-4592-b900-3eaa46838454.2e16e361-17b4-49c6-9092-66c6a4ffd8bf",
         "Managers_T_eca3397d-df4d-4ea6-a74e-22aaef303e3c.2e16e361-17b4-49c6-9092-66c6a4ffd8bf",
         "All Users_T_da7e4d23-78cb-4483-98ed-b9c238308a03.2e16e361-17b4-49c6-9092-66c6a4ffd8bf",
         "All Users_S_da7e4d23-78cb-4483-98ed-b9c238308a03.2e16e361-17b4-49c6-9092-66c6a4ffd8bf",
         "Process Owner_S_9a9f919e-6644-4592-b900-3eaa46838454.2e16e361-17b4-49c6-9092-66c6a4ffd8bf",
         "Managers_S_eca3397d-df4d-4ea6-a74e-22aaef303e3c.2e16e361-17b4-49c6-9092-66c6a4ffd8bf",
         "All Users_S_da7e4d23-78cb-4483-98ed-b9c238308a03.64bbda3f-b456-486a-9679-87d81c4366dd",
         "Process Owner_S_9a9f919e-6644-4592-b900-3eaa46838454.64bbda3f-b456-486a-9679-87d81c4366dd",
         "Managers_S_eca3397d-df4d-4ea6-a74e-22aaef303e3c.64bbda3f-b456-486a-9679-87d81c4366dd",
         "HRManagers_T_6615a4b0-fd38-4ea5-8bc0-69d2f107369e.30c63e29-aacd-4b3b-803f-a09ce65486d2",
         "HiringManagers_T_cd97937f-06ab-43cc-8067-17dea489fdb3.30c63e29-aacd-4b3b-803f-a09ce65486d2",
         "GeneralManagers_T_eb30156e-52c8-4ec5-9be6-02290d02f827.30c63e29-aacd-4b3b-803f-a09ce65486d2",
         "All Users_S_da7e4d23-78cb-4483-98ed-b9c238308a03.30c63e29-aacd-4b3b-803f-a09ce65486d2",
         "HiringManagers_S_cd97937f-06ab-43cc-8067-17dea489fdb3.30c63e29-aacd-4b3b-803f-a09ce65486d2",
         "GeneralManagers_S_eb30156e-52c8-4ec5-9be6-02290d02f827.30c63e29-aacd-4b3b-803f-a09ce65486d2",
         "HRManagers_S_6615a4b0-fd38-4ea5-8bc0-69d2f107369e.30c63e29-aacd-4b3b-803f-a09ce65486d2",
         "HRManagers_T_129c442a-75a1-4a7f-b7df-53d2c8909981.73dd1d1a-b533-46ef-ba79-c94cb3b0de87",
         "GeneralManagers_T_ab886e73-e2ec-4cf4-94a7-0c8dff105001.73dd1d1a-b533-46ef-ba79-c94cb3b0de87",
         "HiringManagers_T_e6497638-1592-4d72-b976-2c8579ada550.73dd1d1a-b533-46ef-ba79-c94cb3b0de87",
         "All Users_T_da7e4d23-78cb-4483-98ed-b9c238308a03.73dd1d1a-b533-46ef-ba79-c94cb3b0de87",
         "All Users_S_da7e4d23-78cb-4483-98ed-b9c238308a03.73dd1d1a-b533-46ef-ba79-c94cb3b0de87",
         "GeneralManagers_S_ab886e73-e2ec-4cf4-94a7-0c8dff105001.73dd1d1a-b533-46ef-ba79-c94cb3b0de87",
         "HRManagers_S_129c442a-75a1-4a7f-b7df-53d2c8909981.73dd1d1a-b533-46ef-ba79-c94cb3b0de87",
         "HiringManagers_S_e6497638-1592-4d72-b976-2c8579ada550.73dd1d1a-b533-46ef-ba79-c94cb3b0de87",
         "Process Owner_T_7a742398-8ba3-4347-a60f-b21d15ea6bc0.f2472b8c-651f-4cd1-9d95-7bc9d3cbc3b7",
         "Managers_T_f319047c-8955-48a1-a6a9-f52d9eaf6f88.f2472b8c-651f-4cd1-9d95-7bc9d3cbc3b7",
         "All Users_T_da7e4d23-78cb-4483-98ed-b9c238308a03.f2472b8c-651f-4cd1-9d95-7bc9d3cbc3b7",
         "All Users_S_da7e4d23-78cb-4483-98ed-b9c238308a03.f2472b8c-651f-4cd1-9d95-7bc9d3cbc3b7",
         "Managers_S_f319047c-8955-48a1-a6a9-f52d9eaf6f88.f2472b8c-651f-4cd1-9d95-7bc9d3cbc3b7",
         "Process Owner_S_7a742398-8ba3-4347-a60f-b21d15ea6bc0.f2472b8c-651f-4cd1-9d95-7bc9d3cbc3b7"
      ]
   }
}

MIME type: application/xml


+ View schema
<?xml version="1.0" encoding="UTF-8"?>
<schema targetNamespace="http://rest.bpm.ibm.com/v1/data/usergroup"
	elementFormDefault="unqualified" xmlns="http://www.w3.org/2001/XMLSchema"
	xmlns:tns="http://rest.bpm.ibm.com/v1/data/usergroup"
	xmlns:data="http://rest.bpm.ibm.com/v1/data/root" 
	xmlns:cmn="http://rest.bpm.ibm.com/v1/data/common">

    <import schemaLocation="BPMRestData.xsd" namespace="http://rest.bpm.ibm.com/v1/data/root" />
    <import schemaLocation="Common.xsd" namespace="http://rest.bpm.ibm.com/v1/data/common" />

    <!-- 
	 This type represents a user that has been defined to the IBM BPM installation.
    -->
    <complexType name="User">
	<complexContent>
	    <extension base="data:Data">
		<sequence>

		    <!-- The numeric ID of the user -->
		    <element name="userID" type="long" />

		    <!-- The alphanumeric user name associated with the user -->
		    <element name="userName" type="string" />

		    <!-- The user's full name -->
		    <element name="fullName" type="string" minOccurs="0" />

		    <!-- This field indicates whether or not this user is disabled. This field is set to false and cannot be changed. -->
		    <element name="isDisabled" type="boolean" />

		    <!-- The timestamp when the user last logged in, This field cannot be changed. -->
		    <element name="lastLoginDate" type="dateTime" />

		    <!-- not used -->
		    <element name="primaryGroup" type="string" minOccurs="0" />

		    <!-- not used -->
		    <element name="emailAddress" type="string" minOccurs="0" />

		    <!-- A list of user preferences (extended attributes) associated with this user -->
		    <element name="userPreferences" type="cmn:Map" minOccurs="0" />

		    <!-- A list of user preferences the user is allowed to manage -->
		    <element name="editableUserPreferences" type="string" minOccurs="0" maxOccurs="unbounded" />

		    <!-- A list of Tasks (taskIds) that the user is collaborating on -->
		    <element name="tasksCollaboration" type="string" minOccurs="0" maxOccurs="unbounded" />

		    <!-- A list of groups to which this user belongs -->
		    <element name="memberships" type="string" maxOccurs="unbounded" minOccurs="0" />
		</sequence>
	    </extension>
	</complexContent>
    </complexType>

    <!-- 
	 This type represents a user with a workload defined to the IBM BPM installation.
    -->
    <complexType name="TeamMember">
	<complexContent>
	    <extension base="tns:User">
		<sequence>

		    <!-- The numeric ID of the user -->
		    <element name="workload" type="integer" />

		</sequence>
	    </extension>
	</complexContent>
    </complexType>
    
    <!-- 
	 This type represents a user with a workload defined to the IBM BPM installation.
    -->
    <complexType name="Expert">
	<complexContent>
	    <extension base="tns:TeamMember">
		<sequence>

		    <!-- TODO what is this -->
		    <element name="completed" type="integer" />
		    
		    <!-- TODO what is this -->
		    <element name="avgHours" type="double" />		    

		</sequence>
	    </extension>
	</complexContent>
    </complexType>
    
    <!-- 
     This type represents an array of Experts
    -->
    <complexType name="Experts">
	<complexContent>
	    <extension base="data:Data">
	    	<sequence>
	    		<!-- MAY CONTAIN  -->
		    	<element name="Experts" type="tns:Expert"  minOccurs="0" maxOccurs="unbounded"/>
		    </sequence>
	    </extension>
	</complexContent>
    </complexType>	
    
   <!-- 
	 This type represents a list of expert users with a workload defined to the IBM BPM installation.
    -->
    <complexType name="ExpertList">
	<complexContent>
	    <extension base="data:Data">
		<sequence>

		    <!--group of users the system identifies as experts on a task  -->
		    <element name="systemIdentifiedUsers" type="tns:Expert" maxOccurs="unbounded" minOccurs="0" />
		    
		    <!--group of users included in the the task expert participant group  -->
		    <element name="expertParticipantGroupUsers" type="tns:Expert" maxOccurs="unbounded" minOccurs="0" />	

		    <!--task expert participant group  -->
		    <element name="expertParticipantGroupDetails" type="tns:Group" />

		</sequence>
	    </extension>
	</complexContent>
    </complexType>    
    
    <!-- 
	 This type represents a user that has been defined to the IBM BPM installation.
    -->
    <complexType name="UserPreferences">
	<complexContent>
	    <extension base="data:Data">
		<sequence>

		    <!-- The user's display name -->
		    <element name="displayName" type="string" />

		    <!-- The user's "Primary Role Description -->
		    <element name="primaryRoleDescription" type="string" />

		    <!-- The user's Task Email Address -->
		    <element name="taskEmailAddress" type="string" />

		    <!-- The user's Phone Number -->
		    <element name="phoneNumber" type="string" />
		    
		    <!-- The user's Street Address -->
		    <element name="streetAddress" type="string" />
		    
		    <!-- The user's City -->
		    <element name="city" type="string" />
		    
		    <!-- The user's State -->
		    <element name="state" type="string" />
		    
  		    <!-- The user's Country -->
		    <element name="country" type="string" />
		    
		    <!-- The user's Postal Code-->
		    <element name="postalCode" type="string" />
		    
		    <!-- The user's Image -->
		    <element name="image" type="string" />

		    <!-- The user's Toolbar Collapsed setting -->
		    <element name="toolbarCollapsed" type="boolean" />			    		    		    
		</sequence>
	    </extension>
	</complexContent>
    </complexType>    

    <!--
	This type represents a group that has been defined to the IBM BPM installation.
    -->
    <complexType name="Group">
	<complexContent>
	    <extension base="data:Data">
		<sequence>

		    <!-- The numeric ID of the group -->
		    <element name="groupID" type="long" />

		    <!-- The alphanumeric name of the group -->
		    <element name="groupName" type="string" />

		    <!-- The display name associated with the group -->
		    <element name="displayName" type="string" />

		    <!-- The description associated with the group -->
		    <element name="description" type="string" />

		    <!-- The information if this group is logically deleted -->
		    <element name="deleted" type="boolean" />

		    <!-- The list of users that are members of this group -->
		    <element name="members" type="string" maxOccurs="unbounded" minOccurs="0" />
		    
		    <!-- The alphanumeric name of the manager group -->
		    <element name="managerGroupName" type="string" minOccurs="0" />		    
		</sequence>
	    </extension>
	</complexContent>
    </complexType>    
    
    <!-- 
	 This type represents a list of zero or more users that have been defined to the IBM BPM installation.
    -->
    <complexType name="UserList">
	<complexContent>
	    <extension base="data:Data">
		<sequence>
		    <element name="users" type="tns:User" maxOccurs="unbounded" minOccurs="0" />
		</sequence>
	    </extension>
	</complexContent>
    </complexType>

    <!-- 
	 This type represents a list of zero or more user groups that have been defined to the IBM BPM installation.
    -->
    <complexType name="GroupList">
	<complexContent>
	    <extension base="data:Data">
		<sequence>
		    <element name="groups" type="tns:Group" maxOccurs="unbounded" minOccurs="0" />
		</sequence>
	    </extension>
	</complexContent>
    </complexType>
    
   	<element name="User" type="tns:User" /> 
  	<element name="TeamMember" type="tns:TeamMember" />
   	<element name="Expert" type="tns:Expert" />    	    
   	<element name="Experts" type="tns:Experts" />    	    
   	<element name="UserPreferences" type="tns:UserPreferences" />
   	<element name="Group" type="tns:Group" />    	
   	<element name="UserList" type="tns:UserList" />    	
   	<element name="GroupList" type="tns:GroupList" />    	

</schema>
+ View example content
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bpm:ResponseData xmlns:bpm='http://rest.bpm.ibm.com/v1/data'>
  <status>200</status>
  <data xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ug='http://rest.bpm.ibm.com/v1/data/usergroup' xsi:type='ug:User'>
    <userID>1</userID>
    <userName>tw_admin</userName>
    <fullName>Internal TW Admin user</fullName>
    <isDisabled>false</isDisabled>
    <userPreferences>
      <item key='Locale'>
        <value xmlns:ns5='http://www.w3.org/2001/XMLSchema' xsi:type='ns5:string'>en</value>
      </item>
    </userPreferences>
    <editableUserPreferences>Alert On Assign And Run</editableUserPreferences>
    <editableUserPreferences>Base Text Direction</editableUserPreferences>
    <editableUserPreferences>Calendar Type</editableUserPreferences>
    <editableUserPreferences>Federated Portal Dashboard Display Order</editableUserPreferences>
    <editableUserPreferences>Image</editableUserPreferences>
    <editableUserPreferences>Locale</editableUserPreferences>
    <editableUserPreferences>Phone Number</editableUserPreferences>
    <editableUserPreferences>Portal Dashboard Display Order</editableUserPreferences>
    <editableUserPreferences>Portal Default Page</editableUserPreferences>
    <editableUserPreferences>Portal Mention Timestamp</editableUserPreferences>
    <editableUserPreferences>Portal Notification New Task To Me</editableUserPreferences>
    <editableUserPreferences>Portal Notification New Task To My Group</editableUserPreferences>
    <editableUserPreferences>Portal Notification On Activity Change</editableUserPreferences>
    <editableUserPreferences>Portal Notification Post Mention</editableUserPreferences>
    <editableUserPreferences>Portal Open Task In New Window</editableUserPreferences>
    <editableUserPreferences>Portal Task List View</editableUserPreferences>
    <editableUserPreferences>Primary Role</editableUserPreferences>
    <editableUserPreferences>Send Connections Notification On New Task</editableUserPreferences>
    <editableUserPreferences>Show Unfollow Messages</editableUserPreferences>
    <editableUserPreferences>Task Email Address</editableUserPreferences>
    <editableUserPreferences>Task Notification</editableUserPreferences>
    <editableUserPreferences>Title</editableUserPreferences>
    <tasksCollaboration>75</tasksCollaboration>
    <memberships>Debug</memberships>
    <memberships>tw_admins</memberships>
    <memberships>tw_authors</memberships>
    <memberships>tw_portal_admins</memberships>
    <memberships>tw_process_owners</memberships>
    <memberships>tw_allusers</memberships>
    <memberships>All Users_T_da7e4d23-78cb-4483-98ed-b9c238308a03.40551a86-bac6-474e-a666-85f9a8a83426</memberships>
    <memberships>All Users_S_da7e4d23-78cb-4483-98ed-b9c238308a03.40551a86-bac6-474e-a666-85f9a8a83426</memberships>
    <memberships>All Users_T_da7e4d23-78cb-4483-98ed-b9c238308a03.36c07d6c-ad75-4a42-9675-95275f281c3f</memberships>
    <memberships>Process Owner_T_9a9f919e-6644-4592-b900-3eaa46838454.2e16e361-17b4-49c6-9092-66c6a4ffd8bf</memberships>
    <memberships>Managers_T_eca3397d-df4d-4ea6-a74e-22aaef303e3c.2e16e361-17b4-49c6-9092-66c6a4ffd8bf</memberships>
    <memberships>All Users_T_da7e4d23-78cb-4483-98ed-b9c238308a03.2e16e361-17b4-49c6-9092-66c6a4ffd8bf</memberships>
    <memberships>All Users_S_da7e4d23-78cb-4483-98ed-b9c238308a03.2e16e361-17b4-49c6-9092-66c6a4ffd8bf</memberships>
    <memberships>Process Owner_S_9a9f919e-6644-4592-b900-3eaa46838454.2e16e361-17b4-49c6-9092-66c6a4ffd8bf</memberships>
    <memberships>Managers_S_eca3397d-df4d-4ea6-a74e-22aaef303e3c.2e16e361-17b4-49c6-9092-66c6a4ffd8bf</memberships>
    <memberships>All Users_S_da7e4d23-78cb-4483-98ed-b9c238308a03.64bbda3f-b456-486a-9679-87d81c4366dd</memberships>
    <memberships>Process Owner_S_9a9f919e-6644-4592-b900-3eaa46838454.64bbda3f-b456-486a-9679-87d81c4366dd</memberships>
    <memberships>Managers_S_eca3397d-df4d-4ea6-a74e-22aaef303e3c.64bbda3f-b456-486a-9679-87d81c4366dd</memberships>
    <memberships>HRManagers_T_6615a4b0-fd38-4ea5-8bc0-69d2f107369e.30c63e29-aacd-4b3b-803f-a09ce65486d2</memberships>
    <memberships>HiringManagers_T_cd97937f-06ab-43cc-8067-17dea489fdb3.30c63e29-aacd-4b3b-803f-a09ce65486d2</memberships>
    <memberships>GeneralManagers_T_eb30156e-52c8-4ec5-9be6-02290d02f827.30c63e29-aacd-4b3b-803f-a09ce65486d2</memberships>
    <memberships>All Users_S_da7e4d23-78cb-4483-98ed-b9c238308a03.30c63e29-aacd-4b3b-803f-a09ce65486d2</memberships>
    <memberships>HiringManagers_S_cd97937f-06ab-43cc-8067-17dea489fdb3.30c63e29-aacd-4b3b-803f-a09ce65486d2</memberships>
    <memberships>GeneralManagers_S_eb30156e-52c8-4ec5-9be6-02290d02f827.30c63e29-aacd-4b3b-803f-a09ce65486d2</memberships>
    <memberships>HRManagers_S_6615a4b0-fd38-4ea5-8bc0-69d2f107369e.30c63e29-aacd-4b3b-803f-a09ce65486d2</memberships>
    <memberships>HRManagers_T_129c442a-75a1-4a7f-b7df-53d2c8909981.73dd1d1a-b533-46ef-ba79-c94cb3b0de87</memberships>
    <memberships>GeneralManagers_T_ab886e73-e2ec-4cf4-94a7-0c8dff105001.73dd1d1a-b533-46ef-ba79-c94cb3b0de87</memberships>
    <memberships>HiringManagers_T_e6497638-1592-4d72-b976-2c8579ada550.73dd1d1a-b533-46ef-ba79-c94cb3b0de87</memberships>
    <memberships>All Users_T_da7e4d23-78cb-4483-98ed-b9c238308a03.73dd1d1a-b533-46ef-ba79-c94cb3b0de87</memberships>
    <memberships>All Users_S_da7e4d23-78cb-4483-98ed-b9c238308a03.73dd1d1a-b533-46ef-ba79-c94cb3b0de87</memberships>
    <memberships>GeneralManagers_S_ab886e73-e2ec-4cf4-94a7-0c8dff105001.73dd1d1a-b533-46ef-ba79-c94cb3b0de87</memberships>
    <memberships>HRManagers_S_129c442a-75a1-4a7f-b7df-53d2c8909981.73dd1d1a-b533-46ef-ba79-c94cb3b0de87</memberships>
    <memberships>HiringManagers_S_e6497638-1592-4d72-b976-2c8579ada550.73dd1d1a-b533-46ef-ba79-c94cb3b0de87</memberships>
    <memberships>Process Owner_T_7a742398-8ba3-4347-a60f-b21d15ea6bc0.f2472b8c-651f-4cd1-9d95-7bc9d3cbc3b7</memberships>
    <memberships>Managers_T_f319047c-8955-48a1-a6a9-f52d9eaf6f88.f2472b8c-651f-4cd1-9d95-7bc9d3cbc3b7</memberships>
    <memberships>All Users_T_da7e4d23-78cb-4483-98ed-b9c238308a03.f2472b8c-651f-4cd1-9d95-7bc9d3cbc3b7</memberships>
    <memberships>All Users_S_da7e4d23-78cb-4483-98ed-b9c238308a03.f2472b8c-651f-4cd1-9d95-7bc9d3cbc3b7</memberships>
    <memberships>Managers_S_f319047c-8955-48a1-a6a9-f52d9eaf6f88.f2472b8c-651f-4cd1-9d95-7bc9d3cbc3b7</memberships>
    <memberships>Process Owner_S_7a742398-8ba3-4347-a60f-b21d15ea6bc0.f2472b8c-651f-4cd1-9d95-7bc9d3cbc3b7</memberships>
  </data>
</bpm:ResponseData>

MIME type: application/x-javascript

Error Response content

Detailed error information.

The default content type is application/json.

MIME type: application/json


+ View schema
{  "description": "WLE Error Response", 
   "type": "object",
   "properties":
   {  "status": {"type": "string",
         "description": "The status of the previous API call."
      },
      "exceptionType": {"type": "string",
         "description": "The classname associated with the exception."
      },
      "errorNumber": {"type": "string",
         "description": "Message ID of the exception."
      },
      "errorMessage": {"type": "string",
         "description": "Message text of the exception."
      },
      "errorMessageParameters": {"type": ["string"], "optional": true,
         "description":"Message text parameters of the exception."
      },
      "programmersDetails": {"type": "object", "optional": true,
         "description":"Additional exception details, for example, a stack trace."
      }
   }
} 

MIME type: application/xml


+ View schema
<?xml version="1.0" encoding="UTF-8"?>
<schema targetNamespace="http://rest.bpm.ibm.com/v1/data/exception"
	elementFormDefault="unqualified" xmlns="http://www.w3.org/2001/XMLSchema"
	xmlns:tns="http://rest.bpm.ibm.com/v1/data/exception"
	xmlns:dat="http://rest.bpm.ibm.com/v1/data/root">

    <import schemaLocation="BPMRestData.xsd" namespace="http://rest.bpm.ibm.com/v1/data/root" />
    
    <!--
	This type represents an error response.
    -->    
    <element name="RestRuntimeException">
	<complexType>
	    <sequence>
		<element name="status" type="string"/>
		<element name="Data" type="tns:ExceptionData">
    		</element>
	    </sequence>
	</complexType>
    </element>

    <!-- 
	 This type contains detailed error information associated with an exception.
    -->
    <complexType name="ExceptionData">
	<sequence>
	    <element name="status" type="string"/>

	    <!-- This specifies the java class name of the exception -->
	    <element name="exceptionType" type="string"/>

	    <!-- The message ID of the error message -->
	    <element name="errorNumber" type="string" minOccurs="0"/>

	    <!-- The complete error message -->
	    <element name="errorMessage" type="string"/>

	    <!-- The list of strings inserted into the error message -->
	    <element name="errorMessageParameters" type="string" minOccurs="0" maxOccurs="unbounded"/>

	    <!-- 
		 The stacktrace associated with the exception.
		 Note that this will be omitted unless the "server-stacktrace-enabled" property
		 is enabled in the server's 100Custom.xml file.
	    -->     
	    <element name="programmersDetails" type="string"></element>
	    
	    <!-- Prior responses.  Set if a bulk command was used -->
	    <element name="responses" type="dat:BulkCommandResponses" minOccurs="0"></element>

            <element name="errorData" type="tns:ErrorData" minOccurs="0" />
	</sequence>
    </complexType>

    <complexType name="ErrorData">
        <sequence>
            <element name="code" type="string" />
            <element name="data" type="string" minOccurs="0" />
        </sequence>
    </complexType>
    
</schema>

MIME type: application/x-javascript

Status codes

The method returns one of the following status codes:
CodeDescription
200 OKSuccess completion.
400 Bad RequestThe parameters are not valid or they are missing.
401 UnauthorizedThe caller is not authorized for this request.
406 Not AcceptableThe requested content type or content encoding is not supported.
500 Internal Server ErrorA severe problem has occurred, programmer's details are provided.

Available since

8.5.5.0

Parent Topic: User Details Resource