API Reference

Create a user

Create a user with a role. Admin only.

POST/auth/usersadmin

Requires the admin role. A duplicate username returns 409.

Body

usernamestringrequired

The new user's username.

passwordstringrequired

The new user's password.

roleenumrequired

One of admin, user, viewer.

Request

cURL

bash

curl -X POST localhost:8000/auth/users \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"username":"alice","password":"correct horse battery staple","role":"user"}'

Responses

201User created

json

{
  "id": 2,
  "username": "alice",
  "role": "user"
}

409Username taken

json

{ "detail": "username 'alice' already exists" }

← PreviousList users Next →Delete a user