---
title: "Create admin user"
method: POST
path: "/auth/admin"
tags: ["Admin User"]
---

# Create admin user

`POST /auth/admin`

Creates the built-in admin user with the given password. The username is always fixed to `admin`.

This endpoint can only be called from localhost (the same machine as the server). The password must satisfy the password policy: at least 12 characters, including uppercase, lowercase, digit, and special characters. The password must not be empty, only whitespace, or match the username.

## Request body

- object
  - `password` string, required — Password for the admin user. Must satisfy the password policy.

## Response `200`

Admin user created successfully.

- StatusResponse
  - `status` string — Operation result status.
  - `message` string — Human-readable status message.

## Other responses

- `400` — Missing or invalid password.
- `409` — Admin user already exists.

---

[API](https://skmtc.net/actiancorp/apis/actian-vectorai-db-authentication-api.md) · [All operations](https://skmtc.net/actiancorp/apis/actian-vectorai-db-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/actiancorp/actian-vectorai-db-authentication-api/versions/1be75c43c359/schema)