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

# Create a map project

`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 both `title` and `description` in the request body.

## Query parameters

- `request` unknown

## Request body

- MapCreateRequest
  - `title` string — Display name for the new map
  - `description` string — Optional description of the map's purpose or contents

## 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
  - `description` string, required — Optional description of the map's purpose or contents
  - `created_on` string, required — ISO timestamp when the map was created
  - `last_edited` string, required — ISO timestamp when the map was last modified

## Other responses

- `422` — Validation Error

## Changes

- **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/336fa31dc1dd/schema)