---
title: "Update alias"
method: POST
path: "/api/v1/edit/alias"
tags: ["Aliases"]
---

# Update alias

`POST /api/v1/edit/alias`

You can update one or more aliases per request. You can also send just attributes you want to change

## Request body

- object
  - `attr` object
    - `active` boolean — is alias active or not
    - `address` string — alias address, for catchall use "@domain.tld"
    - `goto` string — destination address, comma separated
    - `goto_ham` boolean — learn as ham
    - `goto_null` boolean — silently ignore
    - `goto_spam` boolean — learn as spam
    - `private_comment` string
    - `public_comment` string
    - `sogo_visible` boolean — toggle visibility as selectable sender in SOGo
  - `items` object — contains list of aliases you want update

## Response `200`

OK

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

## Other responses

- `401` — Unauthorized

---

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