---
title: "createNavigation"
method: POST
path: "/v2/user/navigations"
tags: ["Navigation"]
---

# createNavigation

`POST /v2/user/navigations`

Create a new navigation configuration. Navigations are immutable and globally accessible across organizations.
Each creation generates a new id. To update a navigation, create a new one.

## Request body

- NavigationCreateRequest — Request payload to create a new navigation configuration
  - `name` string, required — Human-readable name for the navigation configuration
  - `configuration` NavigationConfiguration, required — Navigation configuration organized by sections. Each section contains an array of navigation items.

## Response `201`

Navigation created successfully

- Navigation — A customized workplace navigation configuration. The ID is a content-hash, so identical configurations will have the same ID.
  - `id` string, nullable, required — Navigation unique identifier - a hash of the normalized navigation payload (name + configuration). Identical navigations across orgs will have the same ID.
  - `name` string, required — Human-readable name for the navigation configuration
  - `configuration` NavigationConfiguration, required — Navigation configuration organized by sections. Each section contains an array of navigation items.

---

[API](https://skmtc.net/epilot/apis/user-api.md) · [All operations](https://skmtc.net/epilot/apis/user-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/user-api/revisions/7fae886a3c99/schema)