Swagger Petstore - OpenAPI 3.0
POST/user

Create a user account

Creates a user account from the supplied user details. The request body schema does not require any fields, and only the authenticated user can perform this operation.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

8 body fields

User account details; all fields are optional.

idintegeroptional
The user's identifier.
usernamestringoptional
The user's login name.
firstNamestringoptional
The user's first name.
lastNamestringoptional
The user's last name.
emailstringoptional
The user's email address.
passwordstringoptional
The user's password.
phonestringoptional
The user's phone number.
userStatusintegeroptional
User Status

2 status codes
200Returns the user account object with its identifier and account details.
idintegeroptional
usernamestringoptional
firstNamestringoptional
lastNamestringoptional
emailstringoptional
passwordstringoptional
phonestringoptional
userStatusintegeroptional
User Status
defaultUnexpected error

Error handling

The body schema marks every user field as optional; include username and any other account details you want to associate with the new user. Only the authenticated user can perform this operation.