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
Request
MapCreateRequest
object
title
Title

Display name for the new map

string
default: Untitled Map
description
Description

Optional description of the map’s purpose or contents

string
""

Successful Response

MapResponse
object
id
required
Id

Unique identifier for the map

string
project_id
required
Project Id

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

string
title
required
Title

Display name of the map

string
description
required
Description

Optional description of the map’s purpose or contents

string
created_on
required
Created On

ISO timestamp when the map was created

string
last_edited
required
Last Edited

ISO timestamp when the map was last modified

string

Validation Error

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