Swagger Petstore - OpenAPI 3.0
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.

  • 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.

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

4 status codes
200Returns the created 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 input is invalid.
422Returned when the request fails schema validation.
defaultUnexpected error

Error handling

name and photoUrls are required. status must be one of available, pending, or sold when provided; invalid input returns a 400, and schema validation failures return a 422.