---
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. Projects contain multiple map versions ("maps"),
unattached layer data, and a history of changes to the project. Each edit will
create a new map version.

Accepts `title` in the request body. Returns overarching project id
`project_id` and initial map version id `id`.

```py
result = httpx.post(
    "https://app.mundi.ai/api/maps/create",
    json={"title": "Brazilian catchment areas"},
    headers={"Authorization": f"Bearer {os.environ['MUNDI_API_KEY']}"}
).json()

assert result == {
    "title": "Brazilian catchment areas",
    "created_on": "2025-08-29T12:34:56.789Z",
    "map_link": "https://app.mundi.ai/project/PGJSkB1zj7fT",
    "id": "MWfqcRak59bo",
    "project_id": "PGJSkB1zj7fT"
}
```

## 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

---

[API](https://skmtc.net/buntinglabs/apis/mundi-ai-developer-api.md) · [All operations](https://skmtc.net/buntinglabs/apis/mundi-ai-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/buntinglabs/mundi-ai-developer-api/versions/a74491e93dab/schema)