---
title: "Create new user"
method: POST
path: "/users"
tags: ["User Management"]
---

# Create new user

`POST /users`

Create a new user.

## Request body

- UserCreate — User of the system
  - `name` string, required
  - `email` string, email, required

## Response `201`

User Created

- object
  - `id` string, uuid

## Other responses

- `400` — Missing Required Information
- `409` — Email Already Taken

## Changes

- **2024-10-02** `c9062e3a3c54` — 1 info
  - the endpoint scheme security `jwt` was added to the API
- **2024-10-02** `936529d30a41` — 1 info
  - the endpoint scheme security `jwt` was removed from the API
- **2024-09-18** `041ec1a0e403` — 2 info
  - the endpoint scheme security `jwt` was added to the API
  - the endpoint scheme security `cookieAuth` was removed from the API
- **2024-08-08** `d53276437f78` — 1 info
  - the endpoint scheme security `cookieAuth` was added to the API
- **2024-06-09** `824a07e7f1eb` — 1 breaking, 1 info
  - the response's body type/format changed from `string`/`uuid` to `object`/`` for status `201`
  - added the optional property `id` to the response with the `201` status

[Full history](https://skmtc.dev/pai-os/apis/personal-artificial-intelligence-operating-system-pai-os-api/changes/users/post.md)

---

[API](https://skmtc.dev/pai-os/apis/personal-artificial-intelligence-operating-system-pai-os-api.md) · [All operations](https://skmtc.dev/pai-os/apis/personal-artificial-intelligence-operating-system-pai-os-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pai-os/personal-artificial-intelligence-operating-system-pai-os-api/revisions/3c144b366e19/schema)