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

# Create a new map

`POST /api/maps/create`

Creates a new map project.

This endpoint returns both a map id `id` and project id `project_id`. Projects
can contain multiple map versions ("maps"), unattached layer data, and details
a history of changes to the project. Each edit will create a new map version.

Accepts `title` in the request body.

```py
import httpx
import os

# Create a new map
response = httpx.post(
    "https://api.mundi.ai/api/maps/create",
    json={"title": "My New Map"},
    headers={"Authorization": f"Bearer {os.environ['MUNDI_API_KEY']}"}
)
result = response.json()
```

# Likely JSON output:
# {
#   "id": "M_abc123def456",
#   "project_id": "P_xyz789ghi012",
#   "title": "My New Map",
#   "created_on": "2025-08-29T12:34:56.789Z",
#   "map_link": "https://app.mundi.ai/projects/P_xyz789ghi012"
# }

## Request body

- MapCreateRequest
  - `title` string — Display name for the new map

## Response `200`

Successful Response

- MapResponse
  - `id` string, required — Unique identifier for the map
  - `project_id` string, required — ID of the project containing this map. Projects can contain multiple related maps.
  - `title` string, required — Display name of the map
  - `created_on` string, required — ISO timestamp when the map was created
  - `map_link` string, required — URL to view the map project

## Other responses

- `422` — Validation Error

## Changes

- **2025-08-30** `012ea1e4fbf8` — 2 breaking, 2 warning, 1 info
  - removed the required property `description` from the response with the `200` status
  - removed the required property `last_edited` from the response with the `200` status
  - deleted the `query` request parameter `request`
  - removed the request property `description`
  - …1 more
- **2025-07-30** `61b2addd3ef0` — 1 breaking, 4 info
  - removed the required property `map_link` from the response with the `200` status
  - added the new optional `query` request parameter `request`
  - added the new optional request property `description`
  - added the required property `description` to the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/buntinglabs/apis/mundi-ai-developer-api/changes/api/maps/create/post.md)

---

[API](https://skmtc.dev/buntinglabs/apis/mundi-ai-developer-api.md) · [All operations](https://skmtc.dev/buntinglabs/apis/mundi-ai-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/buntinglabs/mundi-ai-developer-api/revisions/012ea1e4fbf8/schema)