Create Pet

Add a new pet to the store catalog, making it available for adoption.

Pet Lifecycle Workflow

When a new pet enters the system:

Intake: Staff creates a pet record with this endpoint (status: available)

Profile: Pet details include species, breed, age, medical info, photos, and adoption fee

Discovery: Pet appears in search results and listings

Adoption Application: Potential adopters can apply through the adoption endpoints

Adoption: Once approved, pet status changes to adopted

Post-Adoption: Pet record is retained for historical purposes

Access: This operation requires staff permissions (write:pets scope or valid Bearer token). Only authenticated staff members can add pets to the system.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

OAuth 2.0

Authorization Code

deviceCode

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://auth.petstoreapi.com/authorize

Token URL: https://auth.petstoreapi.com/token

Refresh URL: https://auth.petstoreapi.com/refresh

Scopes:

write:pets-Create and update pets

Header Params

Body Params application/jsonRequired

Examples

curl -X POST 'https://api.petstoreapi.com/v1/pets' \ -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "species": "dog", "name": "Buddy", "breed": "Golden Retriever", "ageMonths": 24, "size": "large", "color": "Golden", "gender": "male", "goodWithKids": true, "price": "150.00", "description": "Friendly golden retriever looking for an active family" }'

{ "id": "019b4132-70aa-764f-b315-e2803d882a24", "species": "DOG", "name": "Whiskers", "breed": "Domestic Shorthair", "ageMonths": 18, "size": "SMALL", "color": "Orange Tabby", "gender": "MALE", "goodWithKids": true, "price": "75.00", "currency": "USD", "description": "string", "status": "AVAILABLE", "createdAt": "2025-12-21T13:56:23Z", "updatedAt": "2025-12-21T13:56:23Z", "tenantId": "550e8400-e29b-41d4-a716-446655440000", "photos": [ "http://example.com" ], "medicalInfo": { "spayedNeutered": true, "vaccinated": true, "microchipped": true, "specialNeeds": true, "healthNotes": "string" } }

Pet Lifecycle Workflow#

Request

Responses

Pet Lifecycle Workflow