Swagger Petstore - OpenAPI 3.0
PUT/pet

Replace a pet record

Replaces an existing pet record in the store. Supply name and photoUrls with each request, and use status to set the pet's store status to available, pending, or sold. The pet identifier in the request body must identify the pet to replace.

6 body fields

Pet details that replace the existing pet record.

idintegeroptional
The integer identifier of the pet to replace.
namestringrequired
The pet's name.
categoryobjectoptional
The pet's category, represented by an object with an identifier and name.
photoUrlsarray<string>required
The URLs of the pet's photos.
tagsarray<object>optional
Tags for the pet, each represented by an object 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, photos, and any supplied category, tags, and status.
idintegeroptional
namestringrequired
categoryobjectoptional
photoUrlsarray<string>required
tagsarray<object>optional
statusstringoptional
pet status in the store
Allowed:availablependingsold
400Returned when the pet identifier is invalid.
404Returned when the pet to update is not found.
422Returned when the input fails validation.
defaultUnexpected error

Error handling

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