DRAFT -  DRAFT -  DRAFT -  DRAFT -  DRAFT -  DRAFT -  DRAFT -  DRAFT - 

 3.1.2.2. Add user

VerbURIDescription
POSTv2.0/users

Adds a user.

Normal Response Code(s): 201

Error Response Code(s): identityFault (400, 500, ), badRequest (400), unauthorized (401), forbidden (403), badMethod (405), overLimit (413), serviceUnavailable (503), itemNotFound (404), badMediaType (415)

Table 3.6. Add user Request Parameters
NameStyleTypeDescription
X-Auth-TokenHeader​StringYou need a valid admin token for access.

The X-Auth-Token header should always be supplied.

 

Example 3.13. Add user Request: XML

<?xml version="1.0" encoding="UTF-8"?>
<user xmlns="http://docs.openstack.org/identity/api/v2.0"
      xmlns:OS-KSADM="http://docs.openstack.org/identity/api/ext/OS-KSADM/v1.0"
      enabled="true" email="john.smith@example.org"
      username="jqsmith"
      OS-KSADM:password="secrete"/>

 

Example 3.14. Add user Request: JSON

{
  "user": {
    "username": "jqsmith",
    "email": "john.smith@example.org",
    "enabled": true,
    "OS-KSADM:password": "secrete"
  }
}

 

Example 3.15. Add user Response: XML

<?xml version="1.0" encoding="UTF-8"?>
<user xmlns="http://docs.openstack.org/identity/api/v2.0"
      enabled="true" email="john.smith@example.org"
      username="jqsmith" id="u1000"/>

 

Example 3.16. Add user Response: JSON

{
  "user": {
    "id": "u1000",
    "username": "jqsmith",
    "email": "john.smith@example.org",
    "enabled": true
  }
}