---
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

---

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