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

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

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

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", "age_months": 24, "size": "large", "color": "Golden", "gender": "male", "good_with_kids": true, "good_with_pets": true, "adoption_fee": 150.00, "description": "Friendly golden retriever looking for an active family" }'

{ "id": "pet_c4t_5x7k9m", "species": "DOG", "name": "Whiskers", "breed": "Domestic Shorthair", "ageMonths": 18, "size": "SMALL", "color": "Orange Tabby", "gender": "MALE", "goodWithKids": true, "goodWithPets": true, "adoptionFee": 75, "description": "string", "status": "AVAILABLE", "intakeDate": "2019-08-24", "photos": [ "http://example.com" ], "medicalInfo": { "spayedNeutered": true, "vaccinated": true, "microchipped": true, "specialNeeds": true, "notes": "string" }, "links": { "self": "http://example.com", "adopt": "http://example.com" } }

Pet Lifecycle Workflow#

Request

Responses

Pet Lifecycle Workflow