My API
POST/pet

Create a new pet in the store

Creates a new pet in the store. Supply name and photoUrls at minimum — category, tags, and status are optional. status must be one of available, pending, or sold if provided. Returns the created pet object with its generated identifier.

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

6 body fields

Pet object to create. name and photoUrls are required.

idintegeroptional

The unique identifier for the pet. Generated by the store if omitted.

namestringrequired

The name of the pet.

categoryobjectoptional

A category object containing an id and name for the pet's category.

photoUrlsarray<string>required

An array of URLs pointing to images of the pet. At least one URL is

tagsarray<object>optional

An array of tag objects, each with an id and name, for categorising the pet.

statusstringoptional

pet status in the store

Allowed:availablependingsold

4 status codes
200Returns the created pet object with its unique 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 a required field is missing or the request body is malformed.
422Returned when the request body fails validation, such as an invalid enum value for status.
defaultUnexpected error

Error handling

Omitting name or photoUrls returns a 400. A 422 is returned when the request body fails validation — ensure all required fields are present and properly formatted.