Users¶

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.

GET /users/3.json?include=memberships

Returns the details about user ID 3, and additional detail about the user's project roles and memberships. There are probably other such undocumented features like this.

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)

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

Updates the user of given id.

Deleting a user¶

Deleting a user is not supported yet.