---
title: "Edit Domain Admin user"
method: POST
path: "/api/v1/edit/domain-admin"
tags: ["Domain admin"]
---

# Edit Domain Admin user

`POST /api/v1/edit/domain-admin`

Using this endpoint you can edit a existing Domain Admin user. This user has full control over a domain, and can create new mailboxes and aliases.

## Request body

- object
  - `attr` object
    - `active` boolean — is the domain admin active or not
    - `username_new` string — the username of the domain admin, change this to change the username
    - `domains` string[] — a list of all domains managed by this domain admin
    - `password` string — the new domain admin user password
    - `password2` string — the new domain admin user password for confirmation
  - `items` object — contains the domain admin username you want to edit

## Response `200`

OK

- object
  - `type` 'success' | 'danger' | 'error'
  - `log` unknown[] — contains request object
    - unknown
  - `msg` unknown[]
    - unknown

## Other responses

- `401` — Unauthorized

## Changes

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

- **2020-11-30** `bbf6cdb0d352` — 1 breaking
  - the `attr/active` request property type/format changed from `array`/`` to `boolean`/``
- **2020-10-11** `8bde7b9da273` — 1 info
  - endpoint added
- **2020-06-07** `47523aca063a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/mailcow/apis/mailcow-api/changes/api/v1/edit/domain-admin/post.md)

---

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