3.1.2.2. Add user

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

Verb	URI	Description
POST	`v2.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
Name	Style	Type	Description
`X-Auth-Token`	Header	String	You 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
  }
}

Legal notices