Swagger Petstore - OpenAPI 3.0
POST/pet

Create a pet

Creates a new pet record in the store. Provide name and photoUrls; if you provide status, use one of the listed pet statuses. A 200 response returns the created pet details.

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

6 body fields

Pet data in JSON, XML, or URL-encoded form. name and photoUrls are required.

idintegeroptional
The pet's identifier.
namestringrequired
The pet's name.
categoryobjectoptional
The pet's category, including its 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 pet record, 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 pet input is invalid.
422Returned when pet data fails validation.
defaultReturned when an unexpected error occurs.

Error handling

name and photoUrls are required, and status must be one of: available, pending, or sold. Invalid input returns a 400, and a validation exception returns a 422.