POST/styles

API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….

Call it

bash

curl -fsS -X POST "https://api.mapmap.ai/styles" \
  -H "Authorization: Bearer $MAPMAP_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

Request body

application/json · CreateStyleRequest

Field	Type	Required	Description
name	string	yes	Human-readable style name (1–120 characters); its kebab-case slug seeds the style id.
theme	not stated	no	Optional sn-style theme document. Omitted, version 1 is the default theme carrying `name`.

Responses

201Style created as version 1

Field	Type	Required	Description
id	string	yes	The generated style id.
style_url	string	yes	Immutable URL of the compiled style.
theme	not stated	yes	The theme document that was stored.
version	integer	yes	The published version (always 1 on create).

400Malformed request or name

404Hosted styles not configured on this gateway

422Theme failed sn-style validation; the body's problems list names the offending slot or layer

Error bodies follow the shared problem model documented on API conventions.

Also under styles

GET /styles DELETE /styles/{spec}GET /styles/{spec}POST /styles/{spec}GET /styles/{spec}/theme

Generated from https://api.mapmap.ai/openapi.json on 2026-09-17 · operationId create_style