---
title: "POST /user-hierarchy-structure/{InstanceId}"
method: POST
path: "/user-hierarchy-structure/{InstanceId}"
---

# POST /user-hierarchy-structure/{InstanceId}

`POST /user-hierarchy-structure/{InstanceId}`

Updates the user hierarchy structure: add, remove, and rename user hierarchy levels.

## Path parameters

- `InstanceId` string, required

## Request body

- object
  - `HierarchyStructure` object, required — Contains information about the level hierarchy to update.
    - `LevelOne` object — The update for level one.
      - `Name` string, required — The name of the user hierarchy level. Must not be more than 50 characters.
    - `LevelTwo` object — The update for level two.
      - `Name` string, required — The name of the user hierarchy level. Must not be more than 50 characters.
    - `LevelThree` object — The update for level three.
      - `Name` string, required — The name of the user hierarchy level. Must not be more than 50 characters.
    - `LevelFour` object — The update for level four.
      - `Name` string, required — The name of the user hierarchy level. Must not be more than 50 characters.
    - `LevelFive` object — The update for level five.
      - `Name` string, required — The name of the user hierarchy level. Must not be more than 50 characters.

## Response `200`

Success

## Other responses

- `480` — InvalidRequestException
- `481` — InvalidParameterException
- `482` — ResourceNotFoundException
- `483` — ResourceInUseException
- `484` — ThrottlingException
- `485` — InternalServiceException

---

[API](https://skmtc.net/aws/apis/connect.md) · [All operations](https://skmtc.net/aws/apis/connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/connect/versions/fbcf0a4faed2/schema)