Difference between revisions of "REST API: delegation Resource"

Revision as of 08:22, 7 August 2018

Performs actions related to delegating your own profile and those of your direct reports to a proxy user. A proxy user should be able to perform the same activities as his or her supervisor depending on the role(s) delegated to him or her.

Access Permissions

Note: Users should have the Manage Delegations permissions.

Add a User for Delegation

Allows you to add users to the Delegated users list.

Method: POST
URI: https://{yourDomain}/networking/rest/delegation/
Request: <syntaxhighlight lang="html4strict" enclose="div">

<?xml version="1.0" encoding="UTF-8" ?> <platform> <delegation> <active>false</active> <applicationId>08455b174ee14b26859c44c60f2ceb7b</applicationId> <createdId> <content>b2c6fb3b59ba4f9a9c212f20be284df5</content> <displayValue>Fix Fix2</displayValue> <type>USER</type> <uri>https://localhost/networking/rest/user/b2c6fb3b59ba4f9a9c212f20be284df5</uri> </createdId> <dateCreated>2018-07-26T00:46:41.000Z</dateCreated> <dateModified>2018-07-26T06:09:09.000Z</dateModified> <delegateAccessProfile>false</delegateAccessProfile> <delegatee> <content>b2c6fb3b59ba4f9a9c212f20be284df5</content> <displayValue>Fix Fix2</displayValue> <type>USER</type> <uri>https://localhost/networking/rest/user/b2c6fb3b59ba4f9a9c212f20be284df5</uri> </delegatee> <id>ee35804e4c2942b999d8b5521e786fd7</id> <modifiedId> <content>b2c6fb3b59ba4f9a9c212f20be284df5</content> <displayValue>Fix Fix2</displayValue> <type>USER</type> <uri>https://localhost/networking/rest/user/b2c6fb3b59ba4f9a9c212f20be284df5</uri> </modifiedId> <prinicpalUser> <content>792a8e8725104cb58e5d337ea730f59b</content> <displayValue>Fit fit</displayValue> <type>USER</type> <uri>https://localhost/networking/rest/user/792a8e8725104cb58e5d337ea730f59b</uri> </prinicpalUser> <roleId> <content>18d2099643e64deab4a174dc113a5174</content> <displayValue>Agent</displayValue> <type>ROLE</type> <uri>https://localhost/networking/rest/role/18d2099643e64deab4a174dc113a5174</uri> </roleId> <roleId> <content>c7b03526a90c44cdbbfdaa4e5564c6a9</content> <displayValue>Manager</displayValue> <type>ROLE</type> <uri>https://localhost/networking/rest/role/c7b03526a90c44cdbbfdaa4e5564c6a9</uri> </roleId> </delegation> </platform> </syntaxhighlight>

Response: <syntaxhighlight lang="html4strict" enclose="div">

<?xml version="1.0" encoding="UTF-8" ?> <platform> <message> 0 <description>Success</description> <id><delegationId></id> </message> </platform> </syntaxhighlight>

See also: REST API:Error Codes

Update a User Record

Updates data for a specified User.

Method: PUT

URI: https://{yourDomain}/networking/rest/user/{recordId}
Request: Field elements are optional. If a field is missing, existing data in that field is unaffected. If a field is specified, but empty, any existing data in that field is deleted.

   <user>
       <phone/>
       <street/>
       <city/>
       <first_name>John</first_name>
       <username>userA@gmail.com</username>
       <single_sign_on>0</single_sign_on>
       <employee_number/>
       <fax/>
       <country/>
       <time_zone>12</time_zone>
       <email>userA@gmail.com</email>
       <company>CompanyA</company>
       <last_name>Smith</last_name>
       <active>1</active>
       <language>en</language>
       <mobile/>
       <state/>
       <title/>
       <reports_to>151b28b700dc45abbb12b65ea451fc97</reports_to>

<zip/>

       <alias/>
       <customer_language>en</customer_language>
       <accessibility_mode>1<accessibility_mode> 
       <acts_as_delegate>1<acts_as_delegate> 
       <html_signature>test<html_signature>  //can update only the record for the logged in user      
   </user>

</platform> </syntaxhighlight>

Response: <syntaxhighlight lang="html4strict" enclose="div">

   <message>
       0
       <description>Success</description>
       <id>1818437421</id>      // id of the user that was updated
   </message>

</platform> </syntaxhighlight>

See also: REST API:Error Codes

Update (Reset) Password for a User

Change the password for a new or existing user.

Method: POST
Example
URI: https://{yourDomain}/networking/rest/user/operation/updatePassword
Request: <syntaxhighlight lang="html4strict" enclose="div">

   <user>
       <id>da80488c7e8d4f5a83c66a3bb2590295</id>
       <password>abc</password>
       <longjump_reset_user>1</longjump_reset_user>
       <skip_email>1</skip_email>
   </user>

</platform> </syntaxhighlight>

longjump_reset_user

0 = Password field is required. User is not required to change it at next log in. (default)
1 = Password field does not have to be specified. System automatically generates a new, random password. User is required to change it at next log in.

skip_email

This field is only used for a new user.

0 = Send the Reset Password Email Message notification. (default)
1 = No message is sent.

Response: <syntaxhighlight lang="html4strict" enclose="div">

   <message>
       0
       <description>Success</description>        
   </message>

</platform> </syntaxhighlight>

See also: REST API:Error Codes

Change Password for the Current User

Change the password for the current user.

Method: POST
URI: https://{yourDomain}/networking/rest/user/operation/changePassword

Request: <syntaxhighlight lang="html4strict" enclose="div">

   <user>
       <old_password>world44</old_password>
       <password>pass123</password>
   </user>

</platform> </syntaxhighlight>

Response: <syntaxhighlight lang="html4strict" enclose="div">

   <message>
       0
       <description>Success</description>        
   </message>

</platform> </syntaxhighlight>

See also: REST API:Error Codes

Deactivate a User Record

Makes a User record inactive.

Method: DELETE
URI: https://{yourDomain}/networking/rest/user/{recordId}
Response: <syntaxhighlight lang="html4strict" enclose="div">

   <message>

0 <description>Success</description>

   </message>

</platform> </syntaxhighlight>

See also: REST API:Error Codes

Delete a User Record

Deletes a User record

Method: DELETE
URI: https://{yourDomain}/networking/rest/user/{recordId}?action=delete-forever
Response: <syntaxhighlight lang="html4strict" enclose="div">

   <message>

0 <description>Success</description>

   </message>

</platform> </syntaxhighlight>

See also: REST API:Error Codes

Fields

Notes:

In this object, Boolean fields accept either 1/0 or TRUE/FALSE
Because there are so many fields, and so many of them can be empty, empty fields generally are not returned as part of user data. However, they can still be specified for an update.

Name	Type	Attribute	Description	Additional Information
id	String	Read Only	Record Id
first_name	String	Editable on Add/Update
last_name	String	Editable on Add/Update
company	String	Editable on Add/Update
title	String	Editable on Add/Update
accessibility mode	Boolean	Editable on Add/Update	Options: 1 - Enable accessibility mode 0 - Disable accessibility mode
act as delegate	Boolean	Editable on Add/Update	Options: 1 - Delegated 0 - Not delegated	When delegation is enabled, logged in user can act on behalf of another user
html signature	String	Editable on Update		You are not allowed to edit signatures of other users. You are authorized to edit only your signature. You cannot fetch html_signature through Dynamic search API
time_zone	Integer	Editable on Add/Update		See: Time Zone Codes
date_format	String	Editable on Add/Update		See: Date/Time Formats
reports_to	String	Editable on Add/Update	User's manager/supervisor
employee_number		Editable on Add/Update
language	String	Editable on Add/Update		Two letter language code that is available to tenant (ex: 'en', 'es', 'hi')
email	String	Editable on Add/Update
username	String	Editable on Add/Update
site_name	String	Editable on Add/Update	Optional.	When the name of a Site is specified, it designates the user as a site user, rather than a platform user.
password	String	Writable on Add Only	Password used to login	Password is optional when creating a new user If not provided, a temporary password is generated and sent to the user/tenant via email Learn more: Manage Email Templates - Forgot Reset Password Email Password is not used when retrieving or updating user info Password is not returned as part of user data
security_question	String	Editable on Add/Update	This question confirms the identity of the user who has forgotten the password.	security_question parameter values are: 1. In what city were you born? >> 1 2. What is your first pet's name? >> 2 3. What was your first teacher's name? >> 3 4. Write my own security question >> 4
custom_security_question	String	Editable on Add/Update	This question confirms the identity of the user who has forgotten the password.	If the custom_security_question and security_answer parameters are provided while creating a user through REST API call, then the value for security_question must be '4'.
security_answer	String	Editable on Add/Update	The expected answer.	If the custom_security_question and security_answer parameters are provided while creating a user through REST API call, then the value for security_question must be '4'.
active	Boolean	Editable on Add/Update
single_sign_on	Boolean	Editable on Add/Update
sso_type	Integer	Read Only	Type of single sign on: 1 - Delegated Authentication 2 - SAML	See: Single Sign On
federation_id	String	Read Only		Used in SAML authentication, if SAML is enabled
user_id_type	Number	Editable on Add/Update	1: User ID 2:Federated ID	Used in SAML authentication, if SAML is enabled
enable_mobile	Boolean	Editable on Add/Update	Allow mobile access to the platform
team_id	Integer	Editable on Add/Update
accessProfileId	Integer	Editable on Add/Update
phone	String	Editable on Add/Update
mobile	String	Editable on Add/Update
fax	String	Editable on Add/Update
street	String	Editable on Add/Update
city	String	Editable on Add/Update
state	String	Editable on Add/Update
zip	String	Editable on Add/Update
country	String	Editable on Add/Update
notify_info	Boolean	Editable on Add/Update	Send the Welcome email message	When enabled, a notification email is sent (containing the username, welcome and login information) when a new user is added. Default is 1 (email is sent automatically on new user creation) This value is not stored in the database, and is not returned by a GET.
base_currency	String	Editable on Add/Update	The currency format displayed to the user, and used for data entry
force_password_change_on_login	Boolean	Editable on Add/Update	Force a password change action on first-time login	When enabled, the User is prompted to change the password when logging in for the first time Default is 1 (new user is forced to change password on first login)
force_security_question_change_on_login	Boolean	Editable on Add/Update	Force the user to change their security question the next time they login.	Default value is 1 when a user a new user record is created.
last_login	Date	Read Only	Date and time of last login	UTC Format
date_last_password_change	date	Read Only	Date and time of last password change	UTC Format
customer_language	String	Read Only	Default Language, specified in My Information
full_name	String	Read Only	Full name of the user
date_created	Date	Read Only		UTC Format
created_id	Lookup	Read Only
date_modified	Date	Read Only		UTC Format
modified_id	Lookup	Read Only
community_user_id	String	Read Only	User's ID in the community
auto_generated_community_user_record	Boolean	Read Only	<true> for the initial admin user and any other user IDs automatically generated for the community
user_type	String	Read Only	User type: Platform user (P) or Site User (S)	Platform Users are licensed Users who have a Login (to a Tenant, which is provided by an ISV Platform Users can be automatically included as Site Users (Learn More: Configure a Community Tenant) Site Users are registered through a Site
alias	String	Editable on Add/Update	User's alias in the community
description	String	Editable on Add/Update	User's self-description
photo_id	image	Editable on Add/Update	ID of the User's picture. Access: REST document Resource.
thumbnail_photo_id	image	Editable on Add/Update	ID of the thumbnail image. Access: REST document Resource.
status	String	Editable on Add/Update	User's status
date_status_updated	date	Editable on Add/Update	Last date and time user's status was changed
tenant_id	String	Read Only		Blank when logged in as normal user in a non-community tenant. The ID of the host tenant, when logged in as a community user.
tenant_user_id	String	Read Only
customerId	String	Read Only	Customer ID	The ID of the tenant where the user is logged in: The host tenant ID, when logged in as a user for a normal (non-community) tenant. The ID of the community tenant, when logged in as a community user.
flag_logged_in	Boolean	Read only	True if the user is logged in
custom field(s)			User Fields	User can add fields of various type, including text, date, time, etc.

emailNotificationOptions
userWallPost	Boolean		True to send a notification when someone writes on the user's wall.
recordWallPost	Boolean		True to send a notification when someone writes on the record's wall, if the user is following that record.
documentWallPost	Boolean		True to send a notification when someone writes on a document wall, if the user is following that document.
groupWallPost	Boolean		True to send a notification when someone writes on a group wall, if the user is following that group.
commentOnMyPost	Boolean		True to send a notification when someone comments on one of the user's posts.
commentOnComment	Boolean		True to send a notification when someone comments on one of the user's comments.
like	Boolean		True to send a notification when someone votes "like" on one of the user's posts.

Search

where to start

Feedback

customize and design

resources

Tools

Personal tools

Difference between revisions of "REST API: delegation Resource"

Revision as of 08:22, 7 August 2018

Contents

Access Permissions

Add a User for Delegation

Update a User Record

Update (Reset) Password for a User

Change Password for the Current User

Deactivate a User Record

Delete a User Record

Fields

@@ Line 10: / Line 10: @@
 ;Request:
 :<syntaxhighlight lang="html4strict" enclose="div">
-{
+<?xml version="1.0" encoding="UTF-8" ?>
-  "platform": {
+	<platform>
-    "delegation": {
+		<delegation>
-      "active": "false",
+			<active>false</active>
-      "applicationId": "08455b174ee14b26859c44c60f2ceb7b",
+			<applicationId>08455b174ee14b26859c44c60f2ceb7b</applicationId>
-      "createdId": {
+			<createdId>
-        "content": "b2c6fb3b59ba4f9a9c212f20be284df5",
+				<content>b2c6fb3b59ba4f9a9c212f20be284df5</content>
-        "displayValue": "Fix Fix2",
+				<displayValue>Fix Fix2</displayValue>
-        "type": "USER",
+				<type>USER</type>
-        "uri": "https://localhost/networking/rest/user/b2c6fb3b59ba4f9a9c212f20be284df5"
+				<uri>https://localhost/networking/rest/user/b2c6fb3b59ba4f9a9c212f20be284df5</uri>
-      },
+			</createdId>
-      "dateCreated": "2018-07-26T00:46:41.000Z",
+			<dateCreated>2018-07-26T00:46:41.000Z</dateCreated>
-      "dateModified": "2018-07-26T06:09:09.000Z",
+			<dateModified>2018-07-26T06:09:09.000Z</dateModified>
-      "delegateAccessProfile": "false",
+			<delegateAccessProfile>false</delegateAccessProfile>
-      "delegatee": {
+			<delegatee>
-        "content": "b2c6fb3b59ba4f9a9c212f20be284df5",
+				<content>b2c6fb3b59ba4f9a9c212f20be284df5</content>
-        "displayValue": "Fix Fix2",
+				<displayValue>Fix Fix2</displayValue>
-        "type": "USER",
+				<type>USER</type>
-        "uri": "https://localhost/networking/rest/user/b2c6fb3b59ba4f9a9c212f20be284df5"
+				<uri>https://localhost/networking/rest/user/b2c6fb3b59ba4f9a9c212f20be284df5</uri>
-      },
+			</delegatee>
-      "id": "ee35804e4c2942b999d8b5521e786fd7",
+			<id>ee35804e4c2942b999d8b5521e786fd7</id>
-      "modifiedId": {
+			<modifiedId>
-        "content": "b2c6fb3b59ba4f9a9c212f20be284df5",
+				<content>b2c6fb3b59ba4f9a9c212f20be284df5</content>
-        "displayValue": "Fix Fix2",
+				<displayValue>Fix Fix2</displayValue>
-        "type": "USER",
+				<type>USER</type>
-        "uri": "https://localhost/networking/rest/user/b2c6fb3b59ba4f9a9c212f20be284df5"
+				<uri>https://localhost/networking/rest/user/b2c6fb3b59ba4f9a9c212f20be284df5</uri>
-      },
+			</modifiedId>
-      "prinicpalUser": {
+			<prinicpalUser>
-        "content": "792a8e8725104cb58e5d337ea730f59b",
+				<content>792a8e8725104cb58e5d337ea730f59b</content>
-        "displayValue": "Fit fit",
+				<displayValue>Fit fit</displayValue>
-        "type": "USER",
+				<type>USER</type>
-        "uri": "https://localhost/networking/rest/user/792a8e8725104cb58e5d337ea730f59b"
+				<uri>https://localhost/networking/rest/user/792a8e8725104cb58e5d337ea730f59b</uri>
-      },
+			</prinicpalUser>
-      "roleId": [
+			<roleId>
-        {
+				<content>18d2099643e64deab4a174dc113a5174</content>
-          "content": "18d2099643e64deab4a174dc113a5174",
+				<displayValue>Agent</displayValue>
-          "displayValue": "Agent",
+				<type>ROLE</type>
-          "type": "ROLE",
+				<uri>https://localhost/networking/rest/role/18d2099643e64deab4a174dc113a5174</uri>
-          "uri": "https://localhost/networking/rest/role/18d2099643e64deab4a174dc113a5174"
+			</roleId>
-        },
+			<roleId>
-        {
+				<content>c7b03526a90c44cdbbfdaa4e5564c6a9</content>
-          "content": "c7b03526a90c44cdbbfdaa4e5564c6a9",
+				<displayValue>Manager</displayValue>
-          "displayValue": "Manager",
+				<type>ROLE</type>
-          "type": "ROLE",
+				<uri>https://localhost/networking/rest/role/c7b03526a90c44cdbbfdaa4e5564c6a9</uri>
-          "uri": "https://localhost/networking/rest/role/c7b03526a90c44cdbbfdaa4e5564c6a9"
+			</roleId>
-        }
+		</delegation>
-      ]
+	</platform>
-    }
-  }
-}
-<platform>
-    <user>
-        <phone/>
-        <street/>
-        <city/>
-        <first_name>John</first_name>
-        <username>userA@gmail.com</username>
-        <employee_number/>
-        <single_sign_on>0</single_sign_on>
-        <enable_mobile>true</enable_mobile>
-        <fax/>
-        <country/>
-        <time_zone>12</time_zone>
-        <email>userA@gmail.com</email>
-        <company>CompanyA</company>
-        <last_name>Smith</last_name>
-        <active>1</active>
-        <language>en</language>
-        <mobile/>
-        <state/>
-        <title/>
-        <notify_info>1</notify_info>
-        <reports_to>151b28b700dc45abbb12b65ea451fc97</reports_to>
-        <zip/>
-        <alias/>
-        <customer_language>en</customer_language>
-        <team_id>1</team_id>                  // only required on add
-        <accessProfileId>3</accessProfileId>  // only required on add
-        <accessibility_mode>1<accessibility_mode>
-        <acts_as_delegate>1<acts_as_delegate>
-    </user>
-</platform>
 </syntaxhighlight>
 ;Response:
 :<syntaxhighlight lang="html4strict" enclose="div">
-{
+<?xml version="1.0" encoding="UTF-8" ?>
-"platform": {
+	<platform>
-"message": {
+		<message>
-"code": "0",
+			<code>0</code>
-"description": "Success",
+			<description>Success</description>
-"id": "<delegationId>"
+			<id>&lt;delegationId&gt;</id>
-}
+		</message>
-}
+	</platform>
-}
-<platform>
-    <message>
-        <code>0</code>
-        <description>Success</description>
-        <id>1818437421</id>      // id of the user that was added
-    </message>
-</platform>
 </syntaxhighlight>
 :See also: [[REST API:Error Codes]]