REST API - Create User Request
9 min
/api/v1/usersDescription
Creates a user with specific defined properties.
URL Structure
[Blueprint_URI]/api/v1/usersSupported Methods
- POST
Request Body
The new artifact must be defined in the body of the request. Read more about how to define a user in the request body.
HTTP Status Codes
- 201: Successfully Created
- 207: Partially Successful
- Some of the users could not be created. Refer to the codes in the response for the reason for each unsuccessfully added user:
- 1192: A required value is missing or invalid: username, display name, first name, last name, password.
- 1193: The user was created, but could not be added to a group.
- 1194: The assigned Instance Administrator role does not exist.
- 400: Bad Request This error can occur for a variety of reasons:
- At least one URI or request body parameter is invalid, such as one of the Filter, Traces, Offset or Limit parameters.
- A required value has not been provided.
- 401: Unauthorized
- The Blueprint token is missing, invalid or expired.
- 403: Forbidden
- The applicable permissions are needed. For example, this error can occur when:
- An Author or Collaborate license is needed for access.
- Comment permissions are needed on the artifact.
- Edit permissions are needed on the change summary job.
- 409: Conflict
- Reason for failure can be found in the response body. Additional information may also be found in the log.
Examples
XML Example
Request URI
https://production.blueprintcloud.com/api/v1/usersRequest Body
<?xml version="1.0" ?><Users xmlns="http://www.blueprintsys.com/blueprint/api/v1"> <User> <Email>[email protected]</Email> <Department>Devops</Department> <DisplayName>quaaade</DisplayName> <Firstname>Douglas</Firstname> <Lastname>Quade</Lastname> <Name>dquade</Name> <Enabled>true</Enabled> <Password>@Quaaade#1</Password> <ExpiredPassword>false</ExpiredPassword> <GroupIds xmlns:i="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <i:int>8</i:int> </GroupIds> <Title>Engineer</Title> </User></Users>Response Body
<UserAddResults xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.blueprintsys.com/blueprint/api/v1"> <UserAddResult> <Message>User has been created successfully</Message> <ResultCode>201</ResultCode> <User> <DisplayName>quaaade</DisplayName> <Enabled>false</Enabled> <Firstname>Douglas</Firstname> <Groups /> <Id>3754</Id> <Lastname>Quade</Lastname> <Name>dquade</Name> <Title>Engineer</Title> </User> </UserAddResult></UserAddResults>JSON Example
Request URI
https://production.blueprintcloud.com/api/v1/usersRequest Body
[ { "Type": "User", "Name": "dquade", "DisplayName": "quaaade", "Firstname": "Douglas", "Lastname": "Quade", "GroupIds": [ "1", "8", "12" ], "Title": "Engineer", "Department": "Devops", "Password": "#fR33m4R5", "Enabled": true, "Email": "[email protected]" }]Response Body
[ { "User": { "Type": "User", "Id": 2084, "Name": "dquade", "DisplayName": "quaaade", "Firstname": "Douglas", "Lastname": "Quade", "GroupIds": [ "1", "8", "12" ], "Title": "Engineer", "Department": "Devops", "Password": "#fR33m4R5", "Enabled": true, "Email": "[email protected]" }, "Message": "User has been created successfully", "ResultCode": 201 }]