---
title: "Create a new map"
method: POST
path: "/v1/maps"
tags: ["Maps"]
---

# Create a new map

`POST /v1/maps`

## Request

- Base URL: `https://api.sprixen.com`
- URL: `https://api.sprixen.com/v1/maps`
- Auth: `bearer` (a scheme the document does not define)

## Request body

- CreateMapDto
  - `name` string, required
  - `description` string
  - `gridWidth` number, required
  - `gridHeight` number, required
  - `layers` object: Initial layer data
  - `tilePackSlugs` string[]: Tile pack slugs used in this map
  - `projectionType` 'isometric' | 'top_down' | 'side_view' | 'world': Map projection type (locked after creation)

## Response `201`

Map created

---

[API](https://skmtc.dev/sprixen/apis/sprixen-api.md) · [All operations](https://skmtc.dev/sprixen/apis/sprixen-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sprixen/apis/sprixen-api/revisions/6c0c57f6da58?raw)