Swagger Petstore - OpenAPI 3.0
PUT/pet

Update an existing pet

Replaces an existing pet record in the store. Supply name and photoUrls together with the pet data you want to store, and use status to set its store state. The response contains the updated pet representation.

6 body fields

Complete pet details for the replacement; name and photoUrls are required.

idintegeroptional
The numeric identifier of the pet to update.
namestringrequired
The pet's name.
categoryobjectoptional
The pet's category, including its numeric identifier and name.
photoUrlsarray<string>required
An array of URLs for images of the pet.
tagsarray<object>optional
An array of tags, each containing a numeric 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 store status.
idintegeroptional
namestringrequired
categoryobjectoptional
photoUrlsarray<string>required
tagsarray<object>optional
statusstringoptional
pet status in the store
Allowed:availablependingsold
400Returned when the pet identifier or submitted pet data is invalid.
404Returned when no pet exists with the supplied identifier.
422Returned when the pet fails validation.
defaultReturned when an unexpected error occurs.

Error handling

Omitting name or photoUrls returns a 400. The pet identifier must identify an existing pet, and invalid pet data returns a 422. status must be one of: available, pending, or sold.