User Guide

principal-update 57
For more information about filtering and sorting, see Chapter 2, “Working with Filters,” on
page 21.
Returned elements
principal-list
Sample results
<results>
<status code="ok" />
<principal-list>
<principal principal-id="8" contact-id="3" type="user" has-
children="false" is-primary="false" is-hidden="0">
<name>Enterprise Administrator</name>
<login>[e-mail]</login>
<email>[e-mail]</email>
</principal>
<principal principal-id="18" contact-id="" type="authors" has-
children="true" is-primary="true" is-hidden="0">
<name>Account Authors</name>
<login>Account Authors</login>
<description>Account authors group</description>
</principal>
</principal-list>
</results>
principal-update
Description
Updates information for a principal in the current account or creates a new principal. For
information about principals, see “About principals, SCOs, and IDs” on page 16.
In most cases, you must acquire the original version of the principal’s information (using
principal-info) before calling the principal-update action.
To create a new principal, call the
principal-update action without specifying a principal-id
parameter. If you create a new principal, the returned XML provides information about the new
principal, including the principal’s ID.
has-children
Filter and sort
is-primary
Filter and sort
is-hidden
Filter and sort
name
Filter and sort
login
Filter and sort
description
Filter and sort
Field Filter/Sort