# Modern PetstoreAPI Docs

## Docs
- [Modern Petstore API: A New Gold Standard for OpenAPI](https://docs.petstoreapi.com/modern-petstore-api-a-new-gold-standard-for-openapi-1904527m0.md): 
- [Quick Start Guide](https://docs.petstoreapi.com/quick-start-guide-1904528m0.md): 
- [API Protocols Guide](https://docs.petstoreapi.com/api-protocols-guide-1904529m0.md): 
- Protocol Guides [PetstoreAPI REST Protocol Guide](https://docs.petstoreapi.com/petstoreapi-rest-protocol-guide-1904533m0.md): 
- Protocol Guides [PetstoreAPI GraphQL Protocol Guide](https://docs.petstoreapi.com/petstoreapi-graphql-protocol-guide-1904530m0.md): 
- Protocol Guides [PetstoreAPI gRPC Protocol Guide](https://docs.petstoreapi.com/petstoreapi-grpc-protocol-guide-1904538m0.md): 
- Protocol Guides [PetstoreAPI Server-Sent Events (SSE) Protocol Guide](https://docs.petstoreapi.com/petstoreapi-server-sent-events-sse-protocol-guide-1904535m0.md): 
- Protocol Guides [PetstoreAPI WebSocket Protocol Guide](https://docs.petstoreapi.com/petstoreapi-websocket-protocol-guide-1904537m0.md): 
- Protocol Guides [PetstoreAPI Socket.IO Protocol Guide](https://docs.petstoreapi.com/petstoreapi-socket-io-protocol-guide-1904534m0.md): 
- Protocol Guides [PetstoreAPI MQTT Protocol Guide](https://docs.petstoreapi.com/petstoreapi-mqtt-protocol-guide-1904540m0.md): 
- Protocol Guides [PetstoreAPI Webhooks Protocol Guide](https://docs.petstoreapi.com/petstoreapi-webhooks-protocol-guide-1904536m0.md): 
- Protocol Guides [PetstoreAPI MCP (Model Context Protocol) Guide](https://docs.petstoreapi.com/petstoreapi-mcp-model-context-protocol-guide-1904539m0.md): 

## API Docs
- Pet [Get Pet](https://docs.petstoreapi.com/get-pet-25725398e0.md): Retrieve detailed information about a specific pet.
- Pet [Update Pet](https://docs.petstoreapi.com/update-pet-25725399e0.md): Update information for an existing pet in the catalog.
- Pet [Delete Pet](https://docs.petstoreapi.com/delete-pet-25725400e0.md): Remove a pet from the system permanently.
- Pet [Create Pet](https://docs.petstoreapi.com/create-pet-25725401e0.md): Add a new pet to the store catalog, making it available for adoption.
- Pet [List Pets](https://docs.petstoreapi.com/list-pets-25725402e0.md): Retrieve a paginated list of pets available for adoption with optional filtering.
- Pet [Advanced Pet Search (QUERY method)](https://docs.petstoreapi.com/advanced-pet-search-query-method-27919369e0.md): Perform complex pet searches using the QUERY HTTP method (RFC draft-ietf-httpbis-safe-method-w-body). Unlike GET, this allows sending structured search criteria in the request body while maintaining safe, idempotent semantics.
- Pet [Upload Pet Image](https://docs.petstoreapi.com/upload-pet-image-25725403e0.md): Upload a photo for the specified pet. Supports JPEG, PNG, and WebP formats up to 5MB.
- Chat [Pet Care AI Consultation](https://docs.petstoreapi.com/pet-care-ai-consultation-25725404e0.md): AI-powered consultation service for pet care questions and advice. This endpoint provides expert guidance on pet health, behavior, nutrition, training, and general care through an intelligent conversational interface. Supports streaming responses using Server-Sent Events (SSE) for real-time interaction.
- Payments [Pay Order](https://docs.petstoreapi.com/pay-order-25725405e0.md): Process payment for an existing order.
- Store [Get Store Inventory](https://docs.petstoreapi.com/get-store-inventory-26352282e0.md): Returns aggregated inventory statistics across all pets in the store.
- Store [Create Order](https://docs.petstoreapi.com/create-order-25725407e0.md): Create a new order for pet adoption. The order will be in PLACED status initially
- Store [Get Order](https://docs.petstoreapi.com/get-order-25725408e0.md): Retrieve detailed information about a specific order, including status, items,
- Store [Cancel Order](https://docs.petstoreapi.com/cancel-order-25725409e0.md): Cancel an existing order. Only orders in PLACED or APPROVED status can be cancelled.
- Store [Callback Example](https://docs.petstoreapi.com/callback-example-25725410e0.md): Handles order events and supports asynchronous processing with Callback.
- User [Create User](https://docs.petstoreapi.com/create-user-25725411e0.md): Register a new user account. Returns user details and authentication token.
- User [Update User](https://docs.petstoreapi.com/update-user-25725412e0.md): Update user profile information.
- User [Get User](https://docs.petstoreapi.com/get-user-25725413e0.md): Retrieve public profile information for a specific user.
- User [Delete User Account](https://docs.petstoreapi.com/delete-user-account-25725414e0.md): Permanently delete a user account and all associated data.
- User [Create Authentication Token](https://docs.petstoreapi.com/create-authentication-token-26040857e0.md): Authenticate user credentials and obtain an access token for API requests.
- Webhooks [Order Status Changed Event](https://docs.petstoreapi.com/order-status-changed-event-26350215e0.md): Triggered when an order's status changes. This webhook notifies your system of order lifecycle events, enabling real-time updates for order tracking, notifications, and fulfillment workflows.
- Webhooks [Payment Succeeded Event](https://docs.petstoreapi.com/payment-succeeded-event-26350216e0.md): Triggered when a payment is successfully processed and confirmed. This webhook notifies your system of successful payment transactions, enabling real-time updates for order fulfillment, customer notifications, and accounting workflows.
- pet [Update an existing pet.](https://docs.petstoreapi.com/update-an-existing-pet-25728670e0.md): Update an existing pet by Id.
- pet [Add a new pet to the store.](https://docs.petstoreapi.com/add-a-new-pet-to-the-store-25728671e0.md): Add a new pet to the store.
- pet [Finds Pets by status.](https://docs.petstoreapi.com/finds-pets-by-status-25728672e0.md): Multiple status values can be provided with comma separated strings.
- pet [Finds Pets by tags.](https://docs.petstoreapi.com/finds-pets-by-tags-25728673e0.md): Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.
- pet [Find pet by ID.](https://docs.petstoreapi.com/find-pet-by-id-25728674e0.md): Returns a single pet.
- pet [Updates a pet in the store with form data.](https://docs.petstoreapi.com/updates-a-pet-in-the-store-with-form-data-25728675e0.md): Updates a pet resource based on the form data.
- pet [Deletes a pet.](https://docs.petstoreapi.com/deletes-a-pet-25728676e0.md): Delete a pet.
- pet [Uploads an image.](https://docs.petstoreapi.com/uploads-an-image-25728677e0.md): Upload image of the pet.
- store [Returns pet inventories by status.](https://docs.petstoreapi.com/returns-pet-inventories-by-status-25728678e0.md): Returns a map of status codes to quantities.
- store [Place an order for a pet.](https://docs.petstoreapi.com/place-an-order-for-a-pet-25728679e0.md): Place a new order in the store.
- store [Find purchase order by ID.](https://docs.petstoreapi.com/find-purchase-order-by-id-25728680e0.md): For valid response try integer IDs with value <= 5 or > 10. Other values will generate exceptions.
- store [Delete purchase order by identifier.](https://docs.petstoreapi.com/delete-purchase-order-by-identifier-25728681e0.md): For valid response try integer IDs with value < 1000. Anything above 1000 or non-integers will generate API errors.
- user [Create user.](https://docs.petstoreapi.com/create-user-25728682e0.md): This can only be done by the logged in user.
- user [Creates list of users with given input array.](https://docs.petstoreapi.com/creates-list-of-users-with-given-input-array-25728683e0.md): Creates list of users with given input array.
- user [Logs user into the system.](https://docs.petstoreapi.com/logs-user-into-the-system-25728684e0.md): Log into the system.
- user [Logs out current logged in user session.](https://docs.petstoreapi.com/logs-out-current-logged-in-user-session-25728685e0.md): Log user out of the system.
- user [Get user by user name.](https://docs.petstoreapi.com/get-user-by-user-name-25728686e0.md): Get user detail based on username.
- user [Update user resource.](https://docs.petstoreapi.com/update-user-resource-25728687e0.md): This can only be done by the logged in user.
- user [Delete user resource.](https://docs.petstoreapi.com/delete-user-resource-25728688e0.md): This can only be done by the logged in user.

## Schemas
- [Pet](https://docs.petstoreapi.com/pet-11706909d0.md): 
- [PetCollection](https://docs.petstoreapi.com/petcollection-11706885d0.md): 
- [User](https://docs.petstoreapi.com/user-11706886d0.md): 
- [OrderPayment](https://docs.petstoreapi.com/orderpayment-11706887d0.md): 
- [CardPaymentSource](https://docs.petstoreapi.com/bank-card-11706888d0.md): 
- [BankAccountPaymentSource](https://docs.petstoreapi.com/bank-account-11706889d0.md): 
- [Category](https://docs.petstoreapi.com/category-11706890d0.md): 
- [Links](https://docs.petstoreapi.com/links-11706891d0.md): 
- [Order](https://docs.petstoreapi.com/order-11706892d0.md): 
- [ApiResponse](https://docs.petstoreapi.com/apiresponse-11706893d0.md): 
- [Tag](https://docs.petstoreapi.com/tag-11706894d0.md): 
- [Error](https://docs.petstoreapi.com/error-11706895d0.md): 
- Schemas [Order](https://docs.petstoreapi.com/order-11708147d0.md): 
- Schemas [Category](https://docs.petstoreapi.com/category-11708148d0.md): 
- Schemas [User](https://docs.petstoreapi.com/user-11708149d0.md): 
- Schemas [Tag](https://docs.petstoreapi.com/tag-11708150d0.md): 
- Schemas [Pet](https://docs.petstoreapi.com/pet-11708151d0.md): 
- Schemas [ApiResponse](https://docs.petstoreapi.com/apiresponse-11708152d0.md): 
- RequestBodies [UserArray](https://docs.petstoreapi.com/userarray-11708153d0.md):