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

## 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/a74491e93dab/schema)