Guides

Manage users

Create, retrieve, update, and delete Petstore users.

Use the user operations to manage one user or create a list of users. These operations declare no operation-level security scheme in the published contract.

⚠️Some operation descriptions say that only a logged-in user can create, update, or delete a user, but those operations declare no OpenAPI security requirement. Treat this as an unresolved contract inconsistency; do not assume an authentication mechanism that is not specified.

Create users

Use Create a user for one User object or Create users for an array of user objects.

Retrieve a user

Call Get a user with the username. The contract suggests user1 as a test value.

Update the record

Call Update a user with the current username in the path and a User request body.

Delete the record

Call Delete a user with the username when you no longer need the sample record.

The separate Log in operation sends a username and password as query parameters and returns a string. Avoid placing real credentials in a URL because URLs can be retained in client or intermediary logs.

Next, review the User data model.