Skip to content

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.

request
MapCreateRequest
object
title

Display name for the new map

string
default: Untitled Map
description

Optional description of the map’s purpose or contents

string
""

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

Optional description of the map’s purpose or contents

string
created_on
required

ISO timestamp when the map was created

string
last_edited
required

ISO timestamp when the map was last modified

string

Validation Error

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