Guides

Manage pets

Create, update, upload an image for, and delete a pet record.

Use the pet operations as a lifecycle. These calls change service data and require OAuth 2.0 with the published write:pets and read:pets scopes.

Create a pet

Call Add a pet with a Pet body. Include the required name and photoUrls properties. Save the returned id for later operations.

Update the pet

Use Update a pet to replace fields from a JSON, XML, or form-encoded Pet body. If you need only the name or status query fields, use Update with form data.

Upload an image

Call Upload an image with the pet ID and an application/octet-stream request body. You can attach optional additionalMetadata as a query value.

Delete the pet

When you no longer need the sample record, call Delete a pet with its numeric ID.

⚠️Create, update, upload, and delete operations mutate data. Use identifiers and credentials intended for the sample service; never place a real credential in shared examples or logs.

Next, use Find pets to verify a pet that still exists.