---
title: "Creates a new group alias, or updates an existing one."
method: POST
path: "/identity/group-alias"
tags: ["identity"]
---

# Creates a new group alias, or updates an existing one.

`POST /identity/group-alias`

## Request body

- IdentityGroupAliasRequest
  - `canonical_id` string — ID of the group to which this is an alias.
  - `id` string — ID of the group alias.
  - `mount_accessor` string — Mount accessor to which this alias belongs to.
  - `name` string — Alias of the group.

## Response `200`

OK

---

[API](https://skmtc.net/lensesio/apis/hashicorp-vault-api.md) · [All operations](https://skmtc.net/lensesio/apis/hashicorp-vault-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lensesio/hashicorp-vault-api/versions/bd8194de0697/schema)