---
title: "POST /v1/level"
method: POST
path: "/v1/level"
tags: ["Level"]
---

# POST /v1/level

`POST /v1/level`

## Request

- The document declares no server URL.
- Auth: none declared

## Request body

- MarksmanApiV1CreateLevelRequest
  - `name` string
  - `remark` string
  - `metadata` object
  - `bgColor` string
  - `type` integer

## Response `200`

OK

- MarksmanApiV1CreateLevelReply
  - `uid` string

## Changes

- **2026-03-25** `650c5b44c427`: 1 info
  - added the new optional request property `type`
- **2026-03-24** `b6c8a3179fcc`: 1 info
  - added the new optional request property `bgColor`
- **2026-03-12** `00fc22ea8b5a`: 1 info
  - added the optional property `uid` to the response with the `200` status
- **2026-02-28** `f5912329bb01`: 3 warning
  - removed the request property `bgColor`
  - removed the request property `type`
  - removed the optional property `uid` from the response with the `200` status

[Operation history](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/changes/v1/level/post.md)

---

[API](https://skmtc.dev/aide-family/apis/aide-family-marksman-api.md) - [All operations](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/revisions/26ae221fccba?raw)