API Reference

Pets

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Add a new pet to the store

post/pet

Add a new pet to the store

Body ParametersExpand Collapse

name: string

photoUrls: array of string

id: optional number

category: optional Category { id, name }

id: optional number

name: optional string

status: optional "available" or "pending" or "sold"

pet status in the store

Accepts one of the following:

"available"

"pending"

"sold"

tags: optional array of object { id, name }

id: optional number

name: optional string

ReturnsExpand Collapse

Pet = object { name, photoUrls, id, 3 more }

name: string

photoUrls: array of string

id: optional number

category: optional Category { id, name }

id: optional number

name: optional string

status: optional "available" or "pending" or "sold"

pet status in the store

Accepts one of the following:

"available"

"pending"

"sold"

tags: optional array of object { id, name }

id: optional number

name: optional string

Add a new pet to the store

HTTP

HTTP

TypeScript

curl https://petstore3.swagger.io/api/v3/pet \
    -H 'Content-Type: application/json' \
    -H "api_key: $PETSTORE_API_KEY" \
    -d '{
          "name": "doggie",
          "photoUrls": [
            "string"
          ],
          "id": 10
        }'

200 example

{
  "name": "doggie",
  "photoUrls": [
    "string"
  ],
  "id": 10,
  "category": {
    "id": 1,
    "name": "Dogs"
  },
  "status": "available",
  "tags": [
    {
      "id": 0,
      "name": "name"
    }
  ]
}

Returns Examples

200 example

{
  "name": "doggie",
  "photoUrls": [
    "string"
  ],
  "id": 10,
  "category": {
    "id": 1,
    "name": "Dogs"
  },
  "status": "available",
  "tags": [
    {
      "id": 0,
      "name": "name"
    }
  ]
}