Skip to main content
POST
Create a project

Authorizations

Authorization
string
header
required

Personal API key (mkx_...) created from the MapX account.

Body

application/json

All fields are optional; an empty object creates a project with default title and map state.

title
string

Project title. Optional; defaults to "New Session" when omitted or empty.

Maximum string length: 200
mapState
object

Initial map state. All fields optional. Omitted center/zoom/bearing/pitch default to [0, 0], 2, 0, 0; omitted basemap defaults to { style: "positron", categories: {} }.

Response

Project created.

id
string

Project UUID.

title
string
mapState
object

Current map viewport and basemap state.

updatedAt
string<date-time>