petstore git:20260905.41afbd2A

Immutable. This exact content is served forever at /api/v1/blob/78e898a3de4e23de.

---
name: petstore
description: "Use when you need to update an existing pet or other petstore operations from the shell. Run 'petstore describe' first."
---

# petstore

Generated by declick from https://petstore3.swagger.io/api/v3/openapi.json. Deterministic, no screenshots, JSON by default when piped.

```
petstore (openapi)  source: https://petstore3.swagger.io/api/v3/openapi.json  base: https://petstore3.swagger.io/api/v3
  update-pet                    Update an existing pet. [mutating]
  add-pet                       Add a new pet to the store. [mutating]
  find-pets-by-status           Finds Pets by status.
  find-pets-by-tags             Finds Pets by tags.
  get-pet-by-id <petId>         Find pet by ID.
  update-pet-with-form <petId>  Updates a pet in the store with form data. [mutating]
  delete-pet <petId>            Deletes a pet. [mutating]
  upload-file <petId>           Uploads an image. [mutating]
  get-inventory                 Returns pet inventories by status.
  place-order                   Place an order for a pet. [mutating]
  get-order-by-id <orderId>     Find purchase order by ID.
  delete-order <orderId>        Delete purchase order by identifier. [mutating]
  create-user                   Create user. [mutating]
  create-users-with-list-input  Creates list of users with given input array. [mutating]
  login-user                    Logs user into the system.
  logout-user                   Logs out current logged in user session.
  get-user-by-name <username>   Get user by user name.
  update-user <username>        Update user resource. [mutating]
  delete-user <username>        Delete user resource. [mutating]
common: --json --fields --limit --rows --where --dry-run --full   exit: 0 ok 1 err 2 missing 3 blocked 4 auth
auth env: PETSTORE_PETSTORE_AUTH, PETSTORE_API_KEY
```

Examples (replace UPPERCASE tokens with real values; 'declick describe petstore --verb <verb>' prints one verb's flags and what it returns):

```
petstore update-pet --name doggie --photoUrls PHOTOURLS --dry-run
petstore add-pet --name doggie --photoUrls PHOTOURLS --dry-run
petstore find-pets-by-status --status STATUS
```

If 'petstore' is not on PATH, run every command as: declick run petstore <verb> ... (same output, same exit codes).
Every verb: --json (default when piped) --fields a,b --limit N; mutating verbs accept --dry-run. Success: {"ok":true,"data":...,"meta":{"count":N,"truncated":false}}. Failure: {"ok":false,"error":"...","exit":N}.
Exit 2 means not found, 3 blocked by governance, 4 auth needed (then: declick auth petstore).