t
POST/pet

Create a pet

Creates a new pet in the store. Supply name and photoUrls; status, if provided, must be available, pending, or sold. A 200 response returns the created pet object.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

6 body fields

Pet details to add to the store. name and photoUrls are required.

categoryobjectoptional

The pet category, with an id and name.

idintegeroptional

The pet's int64 identifier.

namestringrequired

The pet's name.

photoUrlsarray<string>required

An array of URLs for photos of the pet.

statusstringoptional

pet status in the store

Allowed:availablependingsold
tagsarray<object>optional

An array of tag objects, each with an id and name.

4 status codes
200Returns the pet object, including its identifier, name, photo URLs, status, category, and tags.
categoryobjectoptional
idintegeroptional
namestringrequired
photoUrlsarray<string>required
statusstringoptional

pet status in the store

Allowed:availablependingsold
tagsarray<object>optional
400Returned when the pet input is invalid.
422Returned when the pet input fails validation.
defaultUnexpected error

Error handling

A 400 is returned when the input is invalid, and a 422 when validation fails. name and photoUrls are required; status, when provided, must be one of available, pending, or sold.