---
title: "Create OS user and register as tenant"
method: POST
path: "/api/super/os-users"
tags: ["Super Admin"]
---

# Create OS user and register as tenant

`POST /api/super/os-users`

## Request body

- object
  - `username` string, required
  - `display_name` string, required
  - `password` string
  - `gateway_mode` boolean
  - `gateway_port` integer
  - `owner_gateway` string
  - `dry_run` boolean
  - `install_openclaw` boolean
  - `install_claude` boolean
  - `install_codex` boolean

## Response `201`

User created

- object

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `403` — Insufficient permissions
- `409` — User already exists
- `429` — Provisioning rate limit exceeded

## Changes

> 27 revisions in range; 1 could not be searched.

- **2026-07-15** `3e34afc46961` — 3 breaking, 2 warning, 4 info
  - the `display_name` request property's minLength was increased from `0` to `1`
  - the `password` request property's minLength was increased from `0` to `12`
  - added the pattern `^[a-z][a-z0-9_-]{1,30}[a-z0-9]$` to the request property `username`
  - the `display_name` request property's maxLength was set to `100`
  - …5 more
- **2026-03-21** `6f26b67f7a0a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/builderz-labs/apis/mission-control-api/changes/api/super/os-users/post.md)

---

[API](https://skmtc.dev/builderz-labs/apis/mission-control-api.md) · [All operations](https://skmtc.dev/builderz-labs/apis/mission-control-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/builderz-labs/mission-control-api/revisions/b920835b2793/schema)