Skip to content
Mundi GIS Documentation

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.

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 required

Section titled “Request Body required ”
MapCreateRequest
object
title

Display name for the new map

string
default: Untitled Map

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

MapResponse
object
id
required

Unique identifier for the map

string
project_id
required

ID of the project containing this map. Projects can contain multiple related maps.

string
title
required

Display name of the map

string
created_on
required

ISO timestamp when the map was created

string
map_link
required

URL to view the map project

string

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string