Swagger Petstore - OpenAPI 3.0
PUT/pet

Replace a pet's details

Replaces an existing pet's details in the store. Supply name and photoUrls with the pet data; status, if provided, must be one of the accepted values. The response contains the updated pet.

6 body fields

Pet details to replace the existing store record, supplied as JSON, XML, or form data. name and photoUrls are required.

idintegeroptional
The pet's numeric identifier.
namestringrequired
The pet's name.
categoryobjectoptional
The pet's category, with an identifier and name.
photoUrlsarray<string>required
A list of URLs for the pet's photos.
tagsarray<object>optional
A list of tags, 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, category, photo URLs, tags, and status.
idintegeroptional
namestringrequired
categoryobjectoptional
photoUrlsarray<string>required
tagsarray<object>optional
statusstringoptional
pet status in the store
Allowed:availablependingsold
400Returned when the supplied ID is invalid.
404Returned when the pet is not found.
422Returned when the request fails validation.
defaultUnexpected error

Error handling

A 400 is returned for an invalid ID, a 404 when the pet is not found, and a 422 for a validation exception. name and photoUrls are required; status, if provided, must be available, pending, or sold.