Swagger Petstore - OpenAPI 3.0
PUT/pet

Replace a pet

Replaces an existing pet's details in the store. Supply name and photoUrls; status, if provided, must be available, pending, or sold. The request provides the pet details to update.

6 body fields

Pet details to replace in the store. name and photoUrls are required.

idintegeroptional
The pet's identifier.
namestringrequired
The pet's name.
categoryobjectoptional
The pet's category, with an identifier and name.
photoUrlsarray<string>required
URLs for photos of the pet.
tagsarray<object>optional
Tags associated with the pet, each with an identifier and name.
statusstringoptional
pet status in the store
Allowed:availablependingsold

5 status codes
200Returns the updated pet object, including its identifier, name, photo URLs, and any supplied category, tags, or status.
idintegeroptional
namestringrequired
categoryobjectoptional
photoUrlsarray<string>required
tagsarray<object>optional
statusstringoptional
pet status in the store
Allowed:availablependingsold
400Returned when the supplied pet ID is invalid.
404Returned when the pet to update is not found.
422Returned when the request fails schema validation.
defaultUnexpected error

Error handling

A 400 is returned when the supplied pet ID is invalid, and a 404 is returned when the pet is not found. name and photoUrls are required; status must be one of available, pending, or sold when provided. Schema validation failures return a 422.