Users¶

• Table of contents
• Users
  • Listing users
  • Showing a user
  • Creating a user
  • Updating a user
  • Deleting a user

Listing users¶

GET /users.xml

Returns users.

Showing a user¶

GET /users/[id].xml

Returns the user of given id.

GET /users/current.xml

Returns the user whose credentials are used to access the API.

Parameters:

• include (optional): a coma separated list of associations to include in the response:
  • memberships
  • groups (added in 2.1)

Example:

GET /users/3.xml?include=memberships,groups

Returns the details about user ID 3, and additional detail about the user's project memberships.

Reponse:

<user>
  <id>3</id>
  <login>jplang</login>
  <firstname>Jean-Philippe</firstname>
  <lastname>Lang</lastname>
  <mail>jp_lang@yahoo.fr</mail>
  <created_on>2007-09-28T00:16:04+02:00</created_on>
  <last_login_on>2011-08-01T18:05:45+02:00</last_login_on>
  <custom_fields type="array" />
  <memberships type="array">
    <membership>
      <project name="Redmine" id="1"/>
      <roles type="array">
        <role name="Administrator" id="3"/>
        <role name="Contributor" id="4"/>
      </roles>
    </membership>
  </memberships>
  <groups type="array">
    <group id="20" name="Developers"/>
  </groups>
</user>

Creating a user¶

POST /users.xml

Creates a user.

Parameters:

• user (required): a hash of the user attributes, including:
  • login (required): the user login
  • password: the user password
  • firstname (required)
  • lastname (required)
  • mail (required)
  • auth_source_id: authentication mode id

Example:

POST /users.xml

<?xml version="1.0" encoding="ISO-8859-1" ?>
<user>
  <login>jplang</login>
  <firstname>Jean-Philippe</firstname>
  <lastname>Lang</lastname>
  <password>secret</password>
  <mail>jp_lang@yahoo.fr</mail>
  <auth_source_id>2</auth_source_id>
</user>

Response:

• 201 Created: user was created
• 422 Unprocessable Entity: user was not created due to validation failures (response body contains the error messages)

Updating a user¶

PUT /users/[id].xml

Parameters:

• user (required): a hash of the user attributes (same as for user creation)

Updates the user of given id.

Deleting a user¶

DELETE /users/[id].xml

Deletes the user of given id.

Response:

• 200 OK: user was deleted