Github user nir-sopher commented on a diff in the pull request: https://github.com/apache/incubator-trafficcontrol/pull/370#discussion_r110366079 --- Diff: docs/source/development/traffic_ops_api/v12/user.rst --- @@ -214,6 +214,153 @@ Users | + +**POST /api/1.2/users** + + Create a user. + + Authentication Required: Yes + + Role(s) Required: admin or oper + + **Request Properties** + + +-------------------------+--------+----------+-------------------------------------------------+ + | Parameter | Type | Required | Description | + +=========================+========+==========+=================================================+ + |``addressLine1`` | string | no | | + +-------------------------+--------+----------+-------------------------------------------------+ + |``addressLine2`` | string | no | | + +-------------------------+--------+----------+-------------------------------------------------+ + |``city`` | string | no | | + +-------------------------+--------+----------+-------------------------------------------------+ + |``confirmLocalPassword`` | string | yes | | + +-------------------------+--------+----------+-------------------------------------------------+ + |``company`` | string | no | | + +-------------------------+--------+----------+-------------------------------------------------+ + |``country`` | string | no | | + +-------------------------+--------+----------+-------------------------------------------------+ + |``email`` | string | yes | | + +-------------------------+--------+----------+-------------------------------------------------+ + |``fullName`` | string | yes | | + +-------------------------+--------+----------+-------------------------------------------------+ + |``localPassword`` | string | yes | | + +-------------------------+--------+----------+-------------------------------------------------+ + |``newUser`` | bool | no | | + +-------------------------+--------+----------+-------------------------------------------------+ + |``phoneNumber`` | string | no | | + +-------------------------+--------+----------+-------------------------------------------------+ + |``postalCode`` | string | no | | + +-------------------------+--------+----------+-------------------------------------------------+ + |``publicSshKey`` | string | no | | + +-------------------------+--------+----------+-------------------------------------------------+ + |``role`` | int | yes | | + +-------------------------+--------+----------+-------------------------------------------------+ + |``stateOrProvince`` | string | no | | + +-------------------------+--------+----------+-------------------------------------------------+ + | ``tenantId`` | int | no | Owning tenant ID | + +-------------------------+--------+----------+-------------------------------------------------+ + |``username`` | string | yes | | + +-------------------------+--------+----------+-------------------------------------------------+ + + + **Request Example** :: + + { + "username": "tsimpson" + "tenantId": 1, + "fullName": "Tom Simpson" + "email": "ema...@email.com" + "role": 6 + "localPassword": "password" + "confirmLocalPassword": "password" + } + +| + + **Response Properties** + + +----------------------+--------+------------------------------------------------+ + | Parameter | Type | Description | + +======================+========+================================================+ + |``addressLine1`` | string | | + +----------------------+--------+------------------------------------------------+ + |``addressLine2`` | string | | + +----------------------+--------+------------------------------------------------+ + |``city`` | string | | + +----------------------+--------+------------------------------------------------+ + |``company`` | string | | + +----------------------+--------+------------------------------------------------+ + |``country`` | string | | + +----------------------+--------+------------------------------------------------+ + |``email`` | string | | + +----------------------+--------+------------------------------------------------+ + |``fullName`` | string | | + +----------------------+--------+------------------------------------------------+ + |``gid`` | int | | + +----------------------+--------+------------------------------------------------+ + |``id`` | int | | + +----------------------+--------+------------------------------------------------+ + |``lastUpdated`` | string | | + +----------------------+--------+------------------------------------------------+ + |``newUser`` | string | | + +----------------------+--------+------------------------------------------------+ + |``phoneNumber`` | string | | + +----------------------+--------+------------------------------------------------+ + |``postalCode`` | string | | + +----------------------+--------+------------------------------------------------+ + |``publicSshKey`` | string | | + +----------------------+--------+------------------------------------------------+ + |``registrationSent`` | bool | | + +----------------------+--------+------------------------------------------------+ + |``role`` | int | | + +----------------------+--------+------------------------------------------------+ + |``roleName`` | string | | + +----------------------+--------+------------------------------------------------+ + |``stateOrProvince`` | string | | + +----------------------+--------+------------------------------------------------+ + |``uid`` | int | | + +----------------------+--------+------------------------------------------------+ + | ``tenantId`` | int | Owning tenant ID | --- End diff -- Ori plans to do so in a separate PR or on the merge with pr 434
--- If your project is set up for it, you can reply to this email and have your reply appear on GitHub as well. If your project does not have this feature enabled and wishes so, or if the feature is enabled but not working, please contact infrastructure at infrastruct...@apache.org or file a JIRA ticket with INFRA. ---