A single request can obtain almost all the information about the logged in user, including rights and preferences. Administrators can update this information using Syncd's web interface, but not via the API.

Request

GET /info/user.xml

Optional parameters

Use the following optional parameters to control which information is included in the response:

include=[all,
         rights,
         preferences]

For instance, the following request will get all available information about the user:

GET /info/user.xml?include=all

Response

Status: 200 OK

<user>
  <id type="integer">25</id>
  <name>walter</name>
  <first-name>Walter</first-name>
  <last-name>Smith</last-name>
  <active type="boolean">true</active>
  <code>WS</code>
  <email>walter@thelazymouse.com</email>
  <url>http://intranet/employees/ws</url>
  <!-- if include=[all || rights] -->
  <rights>
    <admin type="boolean">true</admin>
    <billing-contact type="boolean">true</billing-contact>
    <user-group-manager type="boolean">true</user-group-manager>
    <!-- manager-for-job-type-id references the top level job type
            that this user can manage (all levels below this can
            also be managed) -->
    <manager-for-job-type-id type="integer">7</manager-for-job-type-id>
    <activity-manager type="boolean">true</activity-manager>
    <billing-rate-manager type="boolean">true</billing-rate-manager>
    <expense-category-manager type="boolean">true</expense-category-manager>
    <payment-method-manager type="boolean">true</payment-method-manager>
    <view-billing-rates type="boolean">true</view-billing-rates>
    <view-management-reports type="boolean">true</view-management-reports>
  </rights>
  <!-- end -->
  <!-- if include=[all || preferences] -->
  <preferences>
    <!-- am-pm: true - 12 hour (am/pm) time notation
                false - 24 hour time notation -->
    <am-pm type="boolean">true</am-pm>
    <!-- first-day-of-week: 0 - Sunday
                            1 - Monday
                            2 - Tuesday
                            3 - Wednesday
                            4 - Thursday
                            5 - Friday
                            6 - Saturday -->
    <first-day-of-week type="integer">1</first-day-of-week>
    <!-- date-format: 0 - YYYY/MM/DD
                      1 - YYYY-MM-DD
                      2 - YYYY.MM.DD
                      3 - DD/MM/YYYY
                      4 - DD-MM-YYYY
                      5 - DD.MM.YYYY
                      6 - MM/DD/YYYY
                      7 - MM-DD-YYYY
                      8 - MM.DD.YYYY -->
    <date-format type="integer">0</date-format>
    <!-- duration-format: 0 - Hours . hundredths (e.g. 1.50 hrs)
                          1 - Hours . tenths (e.g. 1.5 hrs)
                          2 - Hours : minutes (e.g. 1:30 hrs) -->
    <duration-format type="integer">2</duration-format>
    <!-- numeric-format: 0 - 1,000.00
                         1 - 1.000,00
                         2 - 1 000.00
                         3 - 1 000,00
                         4 - 1000.00
                         5 - 1000,00 -->
    <numeric-format type="integer">0</numeric-format>
  </preferences>
  <!-- end -->
</user>

Continue to Users

API Basics

Users and Groups

Jobs

Time Tracking

Expense Tracking

Billing Rates