Update profile entries
To update your profile entry, send an updated profile entry document in Atom format to the existing profile's edit web address.All existing profile entry information is replaced with the new data. To avoid deleting all existing data, retrieve any data you want to retain first, and send it back with this request. For example, if you want to add a new tag to a profile entry, retrieve the existing tags, and send them all back with the new tag in the update request. See Retrieve a profile entry for more information.
To find out which fields in a particular profile can be edited, look for the list of <editableField> elements in the service document of the person whose profile you want to edit. You cannot programmatically change which fields can be edited; that can only be done using wsadmin commands. See Customize the Profiles user interface for more details. However, you can change the values stored in the editable fields for a profile by specifying new values for the editable fields represented as corresponding vCard values.
In addition to the default set of fields available for a profile that can be configured as editable by the administrator, the administrator can also add custom fields to a profile. Custom fields are added using extensions; see Add custom extension attributes for Profiles for more details. For information about how to edit the value of a custom field, see Work with profile extensions.
To get the rel="edit" link for a specific person's profile, retrieve a feed of the profile and specify the output=vcard parameter on the request. See Search a user's profile for more details.
Users can only update their own profiles. See Authenticating requests for information about how to authenticate the request.
Table 1. Atom API request details
Method Resource URI Input representation PUT profile Value of the href attribute of the <link rel="edit"> element of the user's profile entry.. profile
Input
Provide a profile entry Atom entry document as the PUT data. The content type of the Atom entry document must be application/atom+xml.The content element of the profile entry must contain a vCard representation of the profile, and the type attribute must be set to text.Use the following table as a guideline of the vCard values that represent editable profile fields:
Table 2. vCard values to use to represent new values for profile fields
<editablefield> element name vCard value alternateLastname X_ALTERNATE_LAST_NAME bldgId X_BUILDING blogUrl X_BLOG_URL;VALUE countryCode X_COUNTRY_CODE courtesyTitle HONORIFIC_PREFIX deptNumber X_DEPARTMENT_NUMBER description X_DESCRIPTION displayName FN EMAIL;INTERNET employeeNumber X_EMPLOYEE_NUMBER employeeTypeCode X_EMPTYPE employeeTypeDesc ROLE experience X_EXPERIENCE faxNumber TEL;FAX floor X_FLOOR groupwareEmail EMAIL;X_GROUPWARE_MAIL guid UID ipTelephoneNumber TEL;X_IP and TEL;PAGER* isManager X_IS_MANAGER jobResp TITLE lastUpdate REV managerUid X_MANAGER_UID mobileNumber TEL;CELL nativeFirstName X_NATIVE_FIRST_NAME nativeLastName X_NATIVE_:LAST_NAME officeName X_OFFICE_NUMBER organizationTitle ORG orgId X_ORGANIZATION_CODE pagerId X_PAGER_ID pagerServiceProvider X_PAGER_PROVIDER pagerType X_PAGER_TYPE preferredFirstName NICKNAME preferredLanguage X_PREFERRED_LANGUAGE preferredLastName X_PREFERRED_LAST_NAME telephoneNumber TEL;WORK timezone TZ uid X_PROFILE_UID URL* X_BLOG_URL;VALUE workLocation ADR;WORK workLocationCode X_WORKLOCATION_CODE
Output
None.Returned HTTP headers
HTTP/1.1 200 OK
Indicates that the profile entry was successfully updated. If an error occurs, this header contains one of the error codes.
Errors
- HTTP/1.1 400 Bad Request
- HTTP/1.1 401 Unauthorized
- HTTP/1.1 404 Not Found
Parent topic
Work with profilesRelated concepts
Work with profile extensions
Related tasks
Customize the Profiles user interfaceRelated reference
Retrieve a profile entry
Search for a user's profile
Profile entry content
Retrieve the Profiles service document