userBrief Data Type

Minimal information about a User. Brief objects are typically returned in list results because they are more efficient to build than their full counterparts.

Namespace
(Default)
Schema
ns0.xsd
Properties
name data type type namespace min/max occurs description
avatar stringIdLinkPair element 0/1 Information about the user's avatar (profile picture). It has three related links:
  • content: the HRef used to download the full image
  • thumbnail: the HRef used to download a square thumbnail of the image
  • scaled_image: the HRef used to download the a scaled, small version of image
first_name string element 0/1 The user's first name.
last_name string element 0/1 The user's last name.
middle_name string element 0/1 The user's middle name.
Properties inherited from principalBrief
email_address string element 0/1 The user or group's primary email address.
name string element 0/1 A unique name for the user or group. For users, this is the user's login name.
Properties inherited from entryBrief
entry_type string element 0/1 The type of entry. Possible values are:
  • entry
  • reply
  • user
  • group
Properties inherited from definableEntityBrief
creation historyStamp element 0/1 Date and time that the entity was created and the user who created it.
description description element 0/1 Description of the entity. For replies, this is the text of the comment.
entity_type string element 0/1 A string identifying the type of this entity. Possible values are user, group, folder, workspace and folderEntry.
id long element 0/1 An ID for the entity. This is guaranteed to be unique for each entity type, but not necessarily unique among all entities.

For example, there will only be 1 user with an ID of 12, but there might also be a folder with an ID of 12.

modification historyStamp element 0/1 The date and time when the entity was last modified and the user who modified it.
parent_binder parentBinder element 0/1 Information about the binder where this entity resides.
permalink link element 0/unbounded  
permalink string element 0/1 A URL in the web application for this entity.
title string element 0/1 The title or displayable name of the entity.
Properties inherited from searchableObject
doc_type string element 0/1 The indexed document type. Possible values are:
  • entry (folder entries, replies, users and groups)
  • binder (workspaces and folders)
  • file
Properties inherited from baseRestObject
href string element 0/1 The path to this resource object. This is relative to the root of the REST API (https://serveraddress/rest).
link link element 0/unbounded Links to related resources. These should be used to navigate the REST API (instead of hard-coding the URLs)

Example

<user_brief>
  <first_name>...</first_name>
  <last_name>...</last_name>
  <middle_name>...</middle_name>
  <avatar>
    <id>...</id>
    <href>...</href>
    <links>
      <link/>
    </links>
  </avatar>
  <name>...</name>
  <email_address>...</email_address>
  <entry_type>...</entry_type>
</user_brief>