---
title: "Create a new Pet"
method: POST
path: "/pets"
tags: ["Pet"]
---

# Create a new Pet

`POST /pets`

Creates a new Pet and persists it to storage.

## Request body

- object
  - `name` string, required
  - `nicknames` string[]
  - `age` integer
  - `categories` integer[]
  - `owner` integer
  - `friends` integer[]

## Response `200`

Pet created

- PetCreate
  - `id` integer, required
  - `name` string, required
  - `nicknames` string[]
  - `age` integer

## Other responses

- `400` — invalid input, data invalid
- `409` — conflicting resources
- `500` — unexpected error

## Changes

- **2022-01-03** `be4e7ff3034b` — 2 breaking, 5 info
  - the `code` response's property type/format changed from `integer`/`int32` to `integer`/`` for status `400`
  - the `code` response's property type/format changed from `integer`/`int32` to `integer`/`` for status `500`
  - added the non-success response with the status `409`
  - the response property `code` became required for the status `400`
  - …3 more
- **2021-12-21** `de0ebba2e9d9` — 2 breaking, 4 info
  - the `age` response's property type/format changed from `integer`/`int32` to `integer`/`` for status `200`
  - the `id` response's property type/format changed from `integer`/`int32` to `integer`/`` for status `200`
  - the `age` request property type/format was generalized from `integer`/`int32` to `integer`/``
  - the `categories/items/` request property type/format was generalized from `integer`/`int32` to `integer`/``
  - …2 more
- **2021-12-20** `c20645e44d2d` — 3 breaking
  - request body became required
  - the `errors` response's property type/format changed from `object`/`` to ``/`` for status `400`
  - the `errors` response's property type/format changed from `object`/`` to ``/`` for status `500`
- …earlier changes not shown

[Full history](https://skmtc.dev/ent/apis/my-pets-api/changes/pets/post.md)

---

[API](https://skmtc.dev/ent/apis/my-pets-api.md) · [All operations](https://skmtc.dev/ent/apis/my-pets-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ent/my-pets-api/revisions/4455d46a2733/schema)