{"openapi":"3.0.0","info":{"title":"Carto-Art Developer API","version":"1.0.0","description":"Programmatically generate beautiful map posters and access cartographic data.","contact":{"name":"Carto-Art Support","email":"support@cartoart.net"}},"servers":[{"url":"/api/v1","description":"API Server"}],"security":[{"bearerAuth":[]}],"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"details":{"type":"object"}}},"FullPosterConfig":{"type":"object","properties":{"location":{"type":"object","properties":{"name":{"type":"string"},"city":{"type":"string"},"subtitle":{"type":"string"},"center":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2},"bounds":{"type":"array","items":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2},"minItems":2,"maxItems":2},"zoom":{"type":"number"}},"additionalProperties":false},"style":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"mapStyle":{"type":"object","properties":{"version":{"type":"number"},"name":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"nullable":true}},"sources":{"type":"object","additionalProperties":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"tiles":{"type":"array","items":{"type":"string"}}},"required":["type"],"additionalProperties":false}},"sprite":{"type":"string"},"glyphs":{"type":"string"},"light":{"nullable":true},"fog":{"nullable":true},"terrain":{"nullable":true},"layers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"nullable":true}},"minzoom":{"type":"number"},"maxzoom":{"type":"number"}},"required":["id","type"],"additionalProperties":false}}},"required":["version","sources","layers"],"additionalProperties":false},"defaultPalette":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"style":{"type":"string"},"background":{"type":"string"},"text":{"type":"string"},"border":{"type":"string"},"roads":{"type":"object","properties":{"motorway":{"type":"string"},"trunk":{"type":"string"},"primary":{"type":"string"},"secondary":{"type":"string"},"tertiary":{"type":"string"},"residential":{"type":"string"},"service":{"type":"string"},"railroad":{"type":"string"},"raceway":{"type":"string"}},"required":["motorway","trunk","primary","secondary","tertiary","residential","service"],"additionalProperties":false},"water":{"type":"string"},"waterLine":{"type":"string"},"greenSpace":{"type":"string"},"landuse":{"type":"string"},"buildings":{"type":"string"},"accent":{"type":"string"},"grid":{"type":"string"},"markerColor":{"type":"string"},"markerTextColor":{"type":"string"},"hillshade":{"type":"string"},"hillshadeHighlight":{"type":"string"},"terrainShadowColor":{"type":"string"},"terrainRamp":{"type":"array","items":{"type":"object","properties":{"elevation":{"type":"number"},"color":{"type":"string"}},"required":["elevation","color"]}},"building3D":{"type":"object","properties":{"colorLow":{"type":"string"},"colorMid":{"type":"string"},"colorHigh":{"type":"string"},"colorRoof":{"type":"string"},"colorEdge":{"type":"string"},"floodLightColor":{"type":"string"},"opacity":{"type":"number"},"lightColor":{"type":"string"},"lightIntensity":{"type":"number"}},"required":["colorLow","colorMid","colorHigh","opacity"],"additionalProperties":false},"primary":{"type":"string"},"secondary":{"type":"string"},"population":{"type":"string"},"parks":{"type":"string"}},"required":["id","name","style","background","text","border","roads","water","waterLine","greenSpace","landuse","buildings"],"additionalProperties":false},"palettes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"style":{"type":"string"},"background":{"type":"string"},"text":{"type":"string"},"border":{"type":"string"},"roads":{"type":"object","properties":{"motorway":{"type":"string"},"trunk":{"type":"string"},"primary":{"type":"string"},"secondary":{"type":"string"},"tertiary":{"type":"string"},"residential":{"type":"string"},"service":{"type":"string"},"railroad":{"type":"string"},"raceway":{"type":"string"}},"required":["motorway","trunk","primary","secondary","tertiary","residential","service"],"additionalProperties":false},"water":{"type":"string"},"waterLine":{"type":"string"},"greenSpace":{"type":"string"},"landuse":{"type":"string"},"buildings":{"type":"string"},"accent":{"type":"string"},"grid":{"type":"string"},"markerColor":{"type":"string"},"markerTextColor":{"type":"string"},"hillshade":{"type":"string"},"hillshadeHighlight":{"type":"string"},"terrainShadowColor":{"type":"string"},"terrainRamp":{"type":"array","items":{"type":"object","properties":{"elevation":{"type":"number"},"color":{"type":"string"}},"required":["elevation","color"]}},"building3D":{"type":"object","properties":{"colorLow":{"type":"string"},"colorMid":{"type":"string"},"colorHigh":{"type":"string"},"colorRoof":{"type":"string"},"colorEdge":{"type":"string"},"floodLightColor":{"type":"string"},"opacity":{"type":"number"},"lightColor":{"type":"string"},"lightIntensity":{"type":"number"}},"required":["colorLow","colorMid","colorHigh","opacity"],"additionalProperties":false},"primary":{"type":"string"},"secondary":{"type":"string"},"population":{"type":"string"},"parks":{"type":"string"}},"required":["id","name","style","background","text","border","roads","water","waterLine","greenSpace","landuse","buildings"],"additionalProperties":false}},"recommendedFonts":{"type":"array","items":{"type":"string"}},"layerToggles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"layerIds":{"type":"array","items":{"type":"string"}}},"required":["id","name","layerIds"],"additionalProperties":false}}},"additionalProperties":false},"palette":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"style":{"type":"string"},"background":{"type":"string"},"text":{"type":"string"},"border":{"type":"string"},"roads":{"type":"object","properties":{"motorway":{"type":"string"},"trunk":{"type":"string"},"primary":{"type":"string"},"secondary":{"type":"string"},"tertiary":{"type":"string"},"residential":{"type":"string"},"service":{"type":"string"},"railroad":{"type":"string"},"raceway":{"type":"string"}},"required":["motorway","trunk","primary","secondary","tertiary","residential","service"],"additionalProperties":false},"water":{"type":"string"},"waterLine":{"type":"string"},"greenSpace":{"type":"string"},"landuse":{"type":"string"},"buildings":{"type":"string"},"accent":{"type":"string"},"grid":{"type":"string"},"markerColor":{"type":"string"},"markerTextColor":{"type":"string"},"hillshade":{"type":"string"},"hillshadeHighlight":{"type":"string"},"terrainShadowColor":{"type":"string"},"terrainRamp":{"type":"array","items":{"type":"object","properties":{"elevation":{"type":"number"},"color":{"type":"string"}},"required":["elevation","color"]}},"building3D":{"type":"object","properties":{"colorLow":{"type":"string"},"colorMid":{"type":"string"},"colorHigh":{"type":"string"},"colorRoof":{"type":"string"},"colorEdge":{"type":"string"},"floodLightColor":{"type":"string"},"opacity":{"type":"number"},"lightColor":{"type":"string"},"lightIntensity":{"type":"number"}},"required":["colorLow","colorMid","colorHigh","opacity"],"additionalProperties":false},"primary":{"type":"string"},"secondary":{"type":"string"},"population":{"type":"string"},"parks":{"type":"string"}},"additionalProperties":false},"typography":{"type":"object","properties":{"titleFont":{"type":"string"},"titleSize":{"type":"number"},"titleWeight":{"type":"number"},"titleLetterSpacing":{"type":"number"},"titleAllCaps":{"type":"boolean"},"subtitleFont":{"type":"string"},"subtitleSize":{"type":"number"},"subtitleWeight":{"type":"number"},"subtitleLetterSpacing":{"type":"number"},"subtitleAllCaps":{"type":"boolean"},"showTitle":{"type":"boolean"},"showSubtitle":{"type":"boolean"},"showCoordinates":{"type":"boolean"},"position":{"type":"string","enum":["bottom-center","bottom-left","bottom-right","top-center","top-left","top-right","center"]},"textBackdrop":{"type":"string","enum":["none","subtle","strong","gradient"]},"backdropHeight":{"type":"number"},"backdropAlpha":{"type":"number"},"backdropSharpness":{"type":"number"},"maxWidth":{"type":"number"},"offsetY":{"type":"number"},"titleColor":{"type":"string"},"subtitleColor":{"type":"string"},"coordinatesColor":{"type":"string"}},"additionalProperties":false},"format":{"type":"object","properties":{"aspectRatio":{"type":"string","enum":["2:3","3:4","4:5","1:1","ISO","16:9","16:10","9:16","9:19.5"]},"orientation":{"type":"string","enum":["portrait","landscape"]},"margin":{"type":"number"},"borderStyle":{"type":"string","enum":["none","thin","thick","double","inset"]},"maskShape":{"type":"string","enum":["rectangular","circular"]},"compassRose":{"type":"boolean"},"texture":{"type":"string","enum":["none","paper","canvas","grain"]},"textureIntensity":{"type":"number"}},"additionalProperties":false},"layers":{"type":"object","properties":{"streets":{"type":"boolean"},"buildings":{"type":"boolean"},"water":{"type":"boolean"},"parks":{"type":"boolean"},"terrain":{"type":"boolean"},"hillshadeExaggeration":{"type":"number"},"population":{"type":"boolean"},"pois":{"type":"boolean"},"airports":{"type":"boolean"},"raceways":{"type":"boolean"},"labels":{"type":"boolean"},"labelSize":{"type":"number"},"labelMaxWidth":{"type":"number"},"labelStyle":{"type":"string","enum":["standard","elevated","glass","vintage"]},"labels-admin":{"type":"boolean"},"labelAdminSize":{"type":"number"},"labels-cities":{"type":"boolean"},"labelCitiesSize":{"type":"number"},"labels-streets":{"type":"boolean"},"labelStreetsSize":{"type":"number"},"boundaries":{"type":"boolean"},"marker":{"type":"boolean"},"markerType":{"type":"string","enum":["pin","crosshair","dot","ring","heart","home"]},"markerColor":{"type":"string"},"roadWeight":{"type":"number"},"racewayWeight":{"type":"number"},"racewayColor":{"type":"string"},"parksMode":{"type":"string","enum":["fill","outlined"]},"volumetricTerrain":{"type":"boolean"},"volumetricTerrainExaggeration":{"type":"number"},"terrainDetailLevel":{"type":"string","enum":["normal","high","ultra"]},"terrainFog":{"type":"boolean"},"terrainFogColor":{"type":"string"},"terrainFogRange":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2},"terrainLightAzimuth":{"type":"number"},"terrainLightAltitude":{"type":"number"},"terrainAmbientLight":{"type":"number"},"terrainDiffuseLight":{"type":"number"},"terrainTileCacheSize":{"type":"number"},"terrainShadows":{"type":"boolean"},"terrainShadowDarkness":{"type":"number"},"terrainColor":{"type":"array","items":{"type":"number"},"minItems":3,"maxItems":3},"terrainShadowColor":{"type":"array","items":{"type":"number"},"minItems":3,"maxItems":3},"terrainHighlightColor":{"type":"array","items":{"type":"number"},"minItems":3,"maxItems":3},"buildings3D":{"type":"boolean"},"buildings3DPitch":{"type":"number"},"buildings3DBearing":{"type":"number"},"buildings3DHeightScale":{"type":"number"},"buildings3DDefaultHeight":{"type":"number"},"buildings3DLightPreset":{"type":"string","enum":["morning","noon","evening","night"]},"buildings3DWireframe":{"type":"boolean"},"buildings3DRoofColor":{"type":"boolean"},"buildings3DShadows":{"type":"boolean"},"buildings3DHighlight":{"type":"boolean"},"buildings3DHighlightId":{"type":"string"},"sunPreset":{"type":"string","enum":["morning","noon","evening","night"]},"landcoverWood":{"type":"boolean"},"landcoverGrass":{"type":"boolean"},"landcoverFarmland":{"type":"boolean"},"landcoverIce":{"type":"boolean"},"landuseForest":{"type":"boolean"},"landuseOrchard":{"type":"boolean"},"landuseVineyard":{"type":"boolean"},"landuseCemetery":{"type":"boolean"},"landuseGrass":{"type":"boolean"},"railroads":{"type":"boolean"},"graticules":{"type":"boolean"},"graticuleWeight":{"type":"number"},"graticuleLabelSize":{"type":"number"},"graticuleDensity":{"type":"number"},"connectMarkers":{"type":"boolean"},"markerPathColor":{"type":"string"},"markerPathWidth":{"type":"number"},"markerPathStyle":{"type":"string","enum":["solid","dashed"]},"showSegmentLengths":{"type":"boolean"},"markerPathLabelStyle":{"type":"string","enum":["standard","elevated","glass","vintage"]},"markerPathLabelSize":{"type":"number"},"fillMarkers":{"type":"boolean"},"markerFillColor":{"type":"string"},"showMarkerLabels":{"type":"boolean"},"showScale":{"type":"boolean"},"colorHillshading":{"type":"boolean"},"colorHillshadingProfile":{"type":"string","enum":["hypsometric","warm-to-cool","bathymetric","monochrome","palette-aware"]},"constellationView":{"type":"boolean"},"constellationDateTime":{"type":"string"},"constellationCorner":{"type":"string","enum":["top-left","top-right","bottom-left","bottom-right"]},"constellationSize":{"type":"number"},"constellationBrightnessCutoff":{"type":"number"},"constellationShowLines":{"type":"boolean"},"constellationLineWidth":{"type":"number"},"constellationLineOpacity":{"type":"number"},"constellationLineStyle":{"type":"string","enum":["solid","dashed","dotted","glowing"]},"constellationShowCompass":{"type":"boolean"},"constellationMaxStarSize":{"type":"number"},"constellationMinStarSize":{"type":"number"},"constellationStarSizeExponent":{"type":"number"},"starChartBase":{"type":"boolean"},"contours":{"type":"boolean"},"contourWeight":{"type":"number"},"contourColor":{"type":"string"},"contourOpacity":{"type":"number"},"coastlineShadow":{"type":"boolean"},"coastlineShadowColor":{"type":"string"},"coastlineShadowOpacity":{"type":"number"},"coastlineShadowBlur":{"type":"number"},"coastlineShadowDirectional":{"type":"boolean"},"coastlineShadowOffset":{"type":"number"}},"additionalProperties":false},"stl":{"type":"object","properties":{"modelHeight":{"type":"number"},"optimization":{"type":"string","enum":["low","medium","high"]},"exportBounds":{"type":"array","items":{"type":"number"},"minItems":4,"maxItems":4},"exportRegionSize":{"type":"number"},"exportCenter":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2}},"additionalProperties":false},"is3DMode":{"type":"boolean"},"markers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"},"label":{"type":"string"},"type":{"type":"string","enum":["pin","crosshair","dot","ring","heart","home"]},"color":{"type":"string"},"size":{"type":"number"},"labelStyle":{"type":"string","enum":["standard","elevated","glass","vintage"]},"labelColor":{"type":"string"},"labelSize":{"type":"number"},"labelVisible":{"type":"boolean"},"visible":{"type":"boolean"},"source":{"type":"string","enum":["manual","gpx-import"]},"role":{"type":"string","enum":["start","finish","waypoint"]},"gpxFileName":{"type":"string"}},"required":["id","lat","lng","type","color","size"],"additionalProperties":false}}},"additionalProperties":false}},"parameters":{},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key"},"cookieAuth":{"type":"apiKey","in":"cookie","name":"sb-access-token"}}},"paths":{"/posters/generate":{"post":{"summary":"Generate a Map Poster","description":"Synchronously renders a high-resolution map poster based on the provided configuration.","tags":["Posters"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"object","properties":{"lat":{"type":"number"},"lng":{"type":"number"}},"required":["lat","lng"]},"style":{"type":"string","default":"minimal"},"text":{"type":"object","properties":{"title":{"type":"string"},"subtitle":{"type":"string"},"show_title":{"type":"boolean","default":true},"show_subtitle":{"type":"boolean","default":true},"show_coordinates":{"type":"boolean","default":true},"position":{"type":"string","enum":["bottom-center","bottom-left","bottom-right","top-center","top-left","top-right","center"],"default":"bottom-center"},"color":{"type":"string"}}},"camera":{"type":"object","properties":{"pitch":{"type":"number","minimum":0,"maximum":80,"default":0},"bearing":{"type":"number","minimum":0,"maximum":360,"default":0},"zoom":{"type":"number","minimum":0,"maximum":20,"default":12}}},"options":{"type":"object","properties":{"buildings_3d":{"type":"boolean","default":false},"high_res":{"type":"boolean","default":false},"streets":{"type":"boolean","default":true},"water":{"type":"boolean","default":true},"parks":{"type":"boolean","default":true},"buildings":{"type":"boolean","default":true},"labels":{"type":"boolean","default":true},"background":{"type":"boolean","default":true},"terrain":{"type":"boolean","default":false},"terrain_under_water":{"type":"boolean","default":false},"contours":{"type":"boolean","default":false},"boundaries":{"type":"boolean","default":false},"population":{"type":"boolean","default":false},"pois":{"type":"boolean","default":false},"marker":{"type":"boolean","default":false},"landcover_wood":{"type":"boolean","default":false},"landcover_grass":{"type":"boolean","default":false},"landcover_farmland":{"type":"boolean","default":false},"landcover_ice":{"type":"boolean","default":false},"landuse_forest":{"type":"boolean","default":false},"landuse_orchard":{"type":"boolean","default":false},"landuse_vineyard":{"type":"boolean","default":false},"landuse_cemetery":{"type":"boolean","default":false},"landuse_grass":{"type":"boolean","default":false}}},"output":{"type":"object","properties":{"format":{"type":"string","enum":["png","jpeg","webp","svg"]},"width":{"type":"integer","minimum":256,"maximum":8000},"height":{"type":"integer","minimum":256,"maximum":8000},"pixelRatio":{"type":"number","minimum":1,"maximum":5}}},"config":{"type":"object","properties":{"location":{"type":"object","properties":{"name":{"type":"string"},"city":{"type":"string"},"subtitle":{"type":"string"},"center":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2},"bounds":{"type":"array","items":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2},"minItems":2,"maxItems":2},"zoom":{"type":"number"}},"additionalProperties":false},"style":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"mapStyle":{"type":"object","properties":{"version":{"type":"number"},"name":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"nullable":true}},"sources":{"type":"object","additionalProperties":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string"},"tiles":{"type":"array","items":{"type":"string"}}},"required":["type"],"additionalProperties":false}},"sprite":{"type":"string"},"glyphs":{"type":"string"},"light":{"nullable":true},"fog":{"nullable":true},"terrain":{"nullable":true},"layers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"nullable":true}},"minzoom":{"type":"number"},"maxzoom":{"type":"number"}},"required":["id","type"],"additionalProperties":false}}},"required":["version","sources","layers"],"additionalProperties":false},"defaultPalette":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"style":{"type":"string"},"background":{"type":"string"},"text":{"type":"string"},"border":{"type":"string"},"roads":{"type":"object","properties":{"motorway":{"type":"string"},"trunk":{"type":"string"},"primary":{"type":"string"},"secondary":{"type":"string"},"tertiary":{"type":"string"},"residential":{"type":"string"},"service":{"type":"string"},"railroad":{"type":"string"},"raceway":{"type":"string"}},"required":["motorway","trunk","primary","secondary","tertiary","residential","service"],"additionalProperties":false},"water":{"type":"string"},"waterLine":{"type":"string"},"greenSpace":{"type":"string"},"landuse":{"type":"string"},"buildings":{"type":"string"},"accent":{"type":"string"},"grid":{"type":"string"},"markerColor":{"type":"string"},"markerTextColor":{"type":"string"},"hillshade":{"type":"string"},"hillshadeHighlight":{"type":"string"},"terrainShadowColor":{"type":"string"},"terrainRamp":{"type":"array","items":{"type":"object","properties":{"elevation":{"type":"number"},"color":{"type":"string"}},"required":["elevation","color"]}},"building3D":{"type":"object","properties":{"colorLow":{"type":"string"},"colorMid":{"type":"string"},"colorHigh":{"type":"string"},"colorRoof":{"type":"string"},"colorEdge":{"type":"string"},"floodLightColor":{"type":"string"},"opacity":{"type":"number"},"lightColor":{"type":"string"},"lightIntensity":{"type":"number"}},"required":["colorLow","colorMid","colorHigh","opacity"],"additionalProperties":false},"primary":{"type":"string"},"secondary":{"type":"string"},"population":{"type":"string"},"parks":{"type":"string"}},"required":["id","name","style","background","text","border","roads","water","waterLine","greenSpace","landuse","buildings"],"additionalProperties":false},"palettes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"style":{"type":"string"},"background":{"type":"string"},"text":{"type":"string"},"border":{"type":"string"},"roads":{"type":"object","properties":{"motorway":{"type":"string"},"trunk":{"type":"string"},"primary":{"type":"string"},"secondary":{"type":"string"},"tertiary":{"type":"string"},"residential":{"type":"string"},"service":{"type":"string"},"railroad":{"type":"string"},"raceway":{"type":"string"}},"required":["motorway","trunk","primary","secondary","tertiary","residential","service"],"additionalProperties":false},"water":{"type":"string"},"waterLine":{"type":"string"},"greenSpace":{"type":"string"},"landuse":{"type":"string"},"buildings":{"type":"string"},"accent":{"type":"string"},"grid":{"type":"string"},"markerColor":{"type":"string"},"markerTextColor":{"type":"string"},"hillshade":{"type":"string"},"hillshadeHighlight":{"type":"string"},"terrainShadowColor":{"type":"string"},"terrainRamp":{"type":"array","items":{"type":"object","properties":{"elevation":{"type":"number"},"color":{"type":"string"}},"required":["elevation","color"]}},"building3D":{"type":"object","properties":{"colorLow":{"type":"string"},"colorMid":{"type":"string"},"colorHigh":{"type":"string"},"colorRoof":{"type":"string"},"colorEdge":{"type":"string"},"floodLightColor":{"type":"string"},"opacity":{"type":"number"},"lightColor":{"type":"string"},"lightIntensity":{"type":"number"}},"required":["colorLow","colorMid","colorHigh","opacity"],"additionalProperties":false},"primary":{"type":"string"},"secondary":{"type":"string"},"population":{"type":"string"},"parks":{"type":"string"}},"required":["id","name","style","background","text","border","roads","water","waterLine","greenSpace","landuse","buildings"],"additionalProperties":false}},"recommendedFonts":{"type":"array","items":{"type":"string"}},"layerToggles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"layerIds":{"type":"array","items":{"type":"string"}}},"required":["id","name","layerIds"],"additionalProperties":false}}},"additionalProperties":false},"palette":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"style":{"type":"string"},"background":{"type":"string"},"text":{"type":"string"},"border":{"type":"string"},"roads":{"type":"object","properties":{"motorway":{"type":"string"},"trunk":{"type":"string"},"primary":{"type":"string"},"secondary":{"type":"string"},"tertiary":{"type":"string"},"residential":{"type":"string"},"service":{"type":"string"},"railroad":{"type":"string"},"raceway":{"type":"string"}},"required":["motorway","trunk","primary","secondary","tertiary","residential","service"],"additionalProperties":false},"water":{"type":"string"},"waterLine":{"type":"string"},"greenSpace":{"type":"string"},"landuse":{"type":"string"},"buildings":{"type":"string"},"accent":{"type":"string"},"grid":{"type":"string"},"markerColor":{"type":"string"},"markerTextColor":{"type":"string"},"hillshade":{"type":"string"},"hillshadeHighlight":{"type":"string"},"terrainShadowColor":{"type":"string"},"terrainRamp":{"type":"array","items":{"type":"object","properties":{"elevation":{"type":"number"},"color":{"type":"string"}},"required":["elevation","color"]}},"building3D":{"type":"object","properties":{"colorLow":{"type":"string"},"colorMid":{"type":"string"},"colorHigh":{"type":"string"},"colorRoof":{"type":"string"},"colorEdge":{"type":"string"},"floodLightColor":{"type":"string"},"opacity":{"type":"number"},"lightColor":{"type":"string"},"lightIntensity":{"type":"number"}},"required":["colorLow","colorMid","colorHigh","opacity"],"additionalProperties":false},"primary":{"type":"string"},"secondary":{"type":"string"},"population":{"type":"string"},"parks":{"type":"string"}},"additionalProperties":false},"typography":{"type":"object","properties":{"titleFont":{"type":"string"},"titleSize":{"type":"number"},"titleWeight":{"type":"number"},"titleLetterSpacing":{"type":"number"},"titleAllCaps":{"type":"boolean"},"subtitleFont":{"type":"string"},"subtitleSize":{"type":"number"},"subtitleWeight":{"type":"number"},"subtitleLetterSpacing":{"type":"number"},"subtitleAllCaps":{"type":"boolean"},"showTitle":{"type":"boolean"},"showSubtitle":{"type":"boolean"},"showCoordinates":{"type":"boolean"},"position":{"type":"string","enum":["bottom-center","bottom-left","bottom-right","top-center","top-left","top-right","center"]},"textBackdrop":{"type":"string","enum":["none","subtle","strong","gradient"]},"backdropHeight":{"type":"number"},"backdropAlpha":{"type":"number"},"backdropSharpness":{"type":"number"},"maxWidth":{"type":"number"},"offsetY":{"type":"number"},"titleColor":{"type":"string"},"subtitleColor":{"type":"string"},"coordinatesColor":{"type":"string"}},"additionalProperties":false},"format":{"type":"object","properties":{"aspectRatio":{"type":"string","enum":["2:3","3:4","4:5","1:1","ISO","16:9","16:10","9:16","9:19.5"]},"orientation":{"type":"string","enum":["portrait","landscape"]},"margin":{"type":"number"},"borderStyle":{"type":"string","enum":["none","thin","thick","double","inset"]},"maskShape":{"type":"string","enum":["rectangular","circular"]},"compassRose":{"type":"boolean"},"texture":{"type":"string","enum":["none","paper","canvas","grain"]},"textureIntensity":{"type":"number"}},"additionalProperties":false},"layers":{"type":"object","properties":{"streets":{"type":"boolean"},"buildings":{"type":"boolean"},"water":{"type":"boolean"},"parks":{"type":"boolean"},"terrain":{"type":"boolean"},"hillshadeExaggeration":{"type":"number"},"population":{"type":"boolean"},"pois":{"type":"boolean"},"airports":{"type":"boolean"},"raceways":{"type":"boolean"},"labels":{"type":"boolean"},"labelSize":{"type":"number"},"labelMaxWidth":{"type":"number"},"labelStyle":{"type":"string","enum":["standard","elevated","glass","vintage"]},"labels-admin":{"type":"boolean"},"labelAdminSize":{"type":"number"},"labels-cities":{"type":"boolean"},"labelCitiesSize":{"type":"number"},"labels-streets":{"type":"boolean"},"labelStreetsSize":{"type":"number"},"boundaries":{"type":"boolean"},"marker":{"type":"boolean"},"markerType":{"type":"string","enum":["pin","crosshair","dot","ring","heart","home"]},"markerColor":{"type":"string"},"roadWeight":{"type":"number"},"racewayWeight":{"type":"number"},"racewayColor":{"type":"string"},"parksMode":{"type":"string","enum":["fill","outlined"]},"volumetricTerrain":{"type":"boolean"},"volumetricTerrainExaggeration":{"type":"number"},"terrainDetailLevel":{"type":"string","enum":["normal","high","ultra"]},"terrainFog":{"type":"boolean"},"terrainFogColor":{"type":"string"},"terrainFogRange":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2},"terrainLightAzimuth":{"type":"number"},"terrainLightAltitude":{"type":"number"},"terrainAmbientLight":{"type":"number"},"terrainDiffuseLight":{"type":"number"},"terrainTileCacheSize":{"type":"number"},"terrainShadows":{"type":"boolean"},"terrainShadowDarkness":{"type":"number"},"terrainColor":{"type":"array","items":{"type":"number"},"minItems":3,"maxItems":3},"terrainShadowColor":{"type":"array","items":{"type":"number"},"minItems":3,"maxItems":3},"terrainHighlightColor":{"type":"array","items":{"type":"number"},"minItems":3,"maxItems":3},"buildings3D":{"type":"boolean"},"buildings3DPitch":{"type":"number"},"buildings3DBearing":{"type":"number"},"buildings3DHeightScale":{"type":"number"},"buildings3DDefaultHeight":{"type":"number"},"buildings3DLightPreset":{"type":"string","enum":["morning","noon","evening","night"]},"buildings3DWireframe":{"type":"boolean"},"buildings3DRoofColor":{"type":"boolean"},"buildings3DShadows":{"type":"boolean"},"buildings3DHighlight":{"type":"boolean"},"buildings3DHighlightId":{"type":"string"},"sunPreset":{"type":"string","enum":["morning","noon","evening","night"]},"landcoverWood":{"type":"boolean"},"landcoverGrass":{"type":"boolean"},"landcoverFarmland":{"type":"boolean"},"landcoverIce":{"type":"boolean"},"landuseForest":{"type":"boolean"},"landuseOrchard":{"type":"boolean"},"landuseVineyard":{"type":"boolean"},"landuseCemetery":{"type":"boolean"},"landuseGrass":{"type":"boolean"},"railroads":{"type":"boolean"},"graticules":{"type":"boolean"},"graticuleWeight":{"type":"number"},"graticuleLabelSize":{"type":"number"},"graticuleDensity":{"type":"number"},"connectMarkers":{"type":"boolean"},"markerPathColor":{"type":"string"},"markerPathWidth":{"type":"number"},"markerPathStyle":{"type":"string","enum":["solid","dashed"]},"showSegmentLengths":{"type":"boolean"},"markerPathLabelStyle":{"type":"string","enum":["standard","elevated","glass","vintage"]},"markerPathLabelSize":{"type":"number"},"fillMarkers":{"type":"boolean"},"markerFillColor":{"type":"string"},"showMarkerLabels":{"type":"boolean"},"showScale":{"type":"boolean"},"colorHillshading":{"type":"boolean"},"colorHillshadingProfile":{"type":"string","enum":["hypsometric","warm-to-cool","bathymetric","monochrome","palette-aware"]},"constellationView":{"type":"boolean"},"constellationDateTime":{"type":"string"},"constellationCorner":{"type":"string","enum":["top-left","top-right","bottom-left","bottom-right"]},"constellationSize":{"type":"number"},"constellationBrightnessCutoff":{"type":"number"},"constellationShowLines":{"type":"boolean"},"constellationLineWidth":{"type":"number"},"constellationLineOpacity":{"type":"number"},"constellationLineStyle":{"type":"string","enum":["solid","dashed","dotted","glowing"]},"constellationShowCompass":{"type":"boolean"},"constellationMaxStarSize":{"type":"number"},"constellationMinStarSize":{"type":"number"},"constellationStarSizeExponent":{"type":"number"},"starChartBase":{"type":"boolean"},"contours":{"type":"boolean"},"contourWeight":{"type":"number"},"contourColor":{"type":"string"},"contourOpacity":{"type":"number"},"coastlineShadow":{"type":"boolean"},"coastlineShadowColor":{"type":"string"},"coastlineShadowOpacity":{"type":"number"},"coastlineShadowBlur":{"type":"number"},"coastlineShadowDirectional":{"type":"boolean"},"coastlineShadowOffset":{"type":"number"}},"additionalProperties":false},"stl":{"type":"object","properties":{"modelHeight":{"type":"number"},"optimization":{"type":"string","enum":["low","medium","high"]},"exportBounds":{"type":"array","items":{"type":"number"},"minItems":4,"maxItems":4},"exportRegionSize":{"type":"number"},"exportCenter":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2}},"additionalProperties":false},"is3DMode":{"type":"boolean"},"markers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"lat":{"type":"number"},"lng":{"type":"number"},"label":{"type":"string"},"type":{"type":"string","enum":["pin","crosshair","dot","ring","heart","home"]},"color":{"type":"string"},"size":{"type":"number"},"labelStyle":{"type":"string","enum":["standard","elevated","glass","vintage"]},"labelColor":{"type":"string"},"labelSize":{"type":"number"},"labelVisible":{"type":"boolean"},"visible":{"type":"boolean"},"source":{"type":"string","enum":["manual","gpx-import"]},"role":{"type":"string","enum":["start","finish","waypoint"]},"gpxFileName":{"type":"string"}},"required":["id","lat","lng","type","color","size"],"additionalProperties":false}}},"additionalProperties":false}},"required":["location"]}}}},"responses":{"200":{"description":"Poster generated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"format":{"type":"string"},"download_url":{"type":"string"},"metadata":{"type":"object","properties":{"render_time_ms":{"type":"number"},"file_size_bytes":{"type":"number"},"dimensions":{"type":"string"}},"required":["render_time_ms","file_size_bytes","dimensions"]}},"required":["id","status","format","download_url","metadata"]}}}},"400":{"description":"Error"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Rendering failed"}}}},"/styles":{"get":{"summary":"List available styles","tags":["Styles"],"security":[],"responses":{"200":{"description":"List of styles","content":{"application/json":{"schema":{"type":"object","properties":{"categories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"palettes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"colors":{"type":"object","properties":{"background":{"type":"string"},"text":{"type":"string"},"border":{"type":"string"},"water":{"type":"string"},"waterLine":{"type":"string"},"greenSpace":{"type":"string"},"landuse":{"type":"string"},"buildings":{"type":"string"},"roads":{"type":"object","properties":{"motorway":{"type":"string"},"trunk":{"type":"string"},"primary":{"type":"string"},"secondary":{"type":"string"},"tertiary":{"type":"string"},"residential":{"type":"string"},"service":{"type":"string"}},"required":["motorway","trunk","primary","secondary","tertiary","residential","service"]},"accent":{"type":"string"},"markerColor":{"type":"string"},"markerTextColor":{"type":"string"},"hillshade":{"type":"string"},"hillshadeHighlight":{"type":"string"},"terrainShadowColor":{"type":"string"},"grid":{"type":"string"}},"required":["background","text","border","water","waterLine","greenSpace","landuse","buildings"]}},"required":["id","name","colors"]}}},"required":["id","name","description","palettes"]}},"legacy":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"palettes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"colors":{"type":"object","properties":{"background":{"type":"string"},"text":{"type":"string"},"border":{"type":"string"},"water":{"type":"string"},"waterLine":{"type":"string"},"greenSpace":{"type":"string"},"landuse":{"type":"string"},"buildings":{"type":"string"},"roads":{"type":"object","properties":{"motorway":{"type":"string"},"trunk":{"type":"string"},"primary":{"type":"string"},"secondary":{"type":"string"},"tertiary":{"type":"string"},"residential":{"type":"string"},"service":{"type":"string"}},"required":["motorway","trunk","primary","secondary","tertiary","residential","service"]},"accent":{"type":"string"},"markerColor":{"type":"string"},"markerTextColor":{"type":"string"},"hillshade":{"type":"string"},"hillshadeHighlight":{"type":"string"},"terrainShadowColor":{"type":"string"},"grid":{"type":"string"}},"required":["background","text","border","water","waterLine","greenSpace","landuse","buildings"]}},"required":["id","name","colors"]}}},"required":["id","name","palettes"]}}},"required":["categories","legacy"]}}}}}}},"/styles/{id}":{"get":{"summary":"Get a style by ID","tags":["Styles"],"security":[],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Style details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"mapStyle":{"nullable":true},"palettes":{"type":"array","items":{"nullable":true}},"recommendedFonts":{"type":"array","items":{"type":"string"}},"layerToggles":{"nullable":true}},"required":["id","name","palettes"]}}}},"404":{"description":"Not Found"}}}},"/maps":{"post":{"summary":"Create a new map","tags":["Maps"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"config":{"type":"object","properties":{"location":{"type":"object","properties":{"lat":{"type":"number"},"lng":{"type":"number"}},"required":["lat","lng"]},"style":{"type":"string","default":"minimal"},"text":{"type":"object","properties":{"title":{"type":"string"},"subtitle":{"type":"string"},"show_title":{"type":"boolean","default":true},"show_subtitle":{"type":"boolean","default":true},"show_coordinates":{"type":"boolean","default":true},"position":{"type":"string","enum":["bottom-center","bottom-left","bottom-right","top-center","top-left","top-right","center"],"default":"bottom-center"},"color":{"type":"string"}}},"camera":{"type":"object","properties":{"pitch":{"type":"number","minimum":0,"maximum":80,"default":0},"bearing":{"type":"number","minimum":0,"maximum":360,"default":0},"zoom":{"type":"number","minimum":0,"maximum":20,"default":12}}},"options":{"type":"object","properties":{"buildings_3d":{"type":"boolean","default":false},"high_res":{"type":"boolean","default":false},"streets":{"type":"boolean","default":true},"water":{"type":"boolean","default":true},"parks":{"type":"boolean","default":true},"buildings":{"type":"boolean","default":true},"labels":{"type":"boolean","default":true},"background":{"type":"boolean","default":true},"terrain":{"type":"boolean","default":false},"terrain_under_water":{"type":"boolean","default":false},"contours":{"type":"boolean","default":false},"boundaries":{"type":"boolean","default":false},"population":{"type":"boolean","default":false},"pois":{"type":"boolean","default":false},"marker":{"type":"boolean","default":false},"landcover_wood":{"type":"boolean","default":false},"landcover_grass":{"type":"boolean","default":false},"landcover_farmland":{"type":"boolean","default":false},"landcover_ice":{"type":"boolean","default":false},"landuse_forest":{"type":"boolean","default":false},"landuse_orchard":{"type":"boolean","default":false},"landuse_vineyard":{"type":"boolean","default":false},"landuse_cemetery":{"type":"boolean","default":false},"landuse_grass":{"type":"boolean","default":false}}}},"required":["location"]},"title":{"type":"string","minLength":1,"maxLength":100},"subtitle":{"type":"string"},"is_published":{"type":"boolean","default":false}},"required":["config","title"]}}}},"responses":{"201":{"description":"Map created","content":{"application/json":{"schema":{"type":"object","properties":{"map":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string","nullable":true},"config":{"nullable":true},"user_id":{"type":"string"},"is_published":{"type":"boolean"},"published_at":{"type":"string","nullable":true},"thumbnail_url":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","title","user_id","is_published"]}},"required":["map"]}}}},"400":{"description":"Error"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"}}},"get":{"summary":"List your maps","tags":["Maps"],"parameters":[{"schema":{"anyOf":[{"type":"string","enum":["true"]},{"type":"string","enum":["false"]}]},"required":false,"name":"is_published","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"integer","nullable":true,"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"List of maps","content":{"application/json":{"schema":{"type":"object","properties":{"maps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string","nullable":true},"config":{"nullable":true},"user_id":{"type":"string"},"is_published":{"type":"boolean"},"published_at":{"type":"string","nullable":true},"thumbnail_url":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","title","user_id","is_published"]}},"total":{"type":"number"}},"required":["maps","total"]}}}},"400":{"description":"Error"},"401":{"description":"Unauthorized"}}}},"/maps/{id}":{"get":{"summary":"Get a map by ID","tags":["Maps"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Map details","content":{"application/json":{"schema":{"type":"object","properties":{"map":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string","nullable":true},"config":{"nullable":true},"user_id":{"type":"string"},"is_published":{"type":"boolean"},"published_at":{"type":"string","nullable":true},"thumbnail_url":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","title","user_id","is_published"]}},"required":["map"]}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}}},"patch":{"summary":"Update a map","tags":["Maps"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":100},"subtitle":{"type":"string","nullable":true,"maxLength":200},"is_published":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Map updated","content":{"application/json":{"schema":{"type":"object","properties":{"map":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"subtitle":{"type":"string","nullable":true},"config":{"nullable":true},"user_id":{"type":"string"},"is_published":{"type":"boolean"},"published_at":{"type":"string","nullable":true},"thumbnail_url":{"type":"string","nullable":true},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","title","user_id","is_published"]}},"required":["map"]}}}},"400":{"description":"Error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}}},"delete":{"summary":"Delete a map","tags":["Maps"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"No Content"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}}}},"/maps/{id}/vote":{"post":{"summary":"Vote on a map","tags":["Votes"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"value":{"type":"number"}},"required":["value"]}}}},"responses":{"200":{"description":"Vote recorded","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"400":{"description":"Error"},"401":{"description":"Unauthorized"},"403":{"description":"Map is not published"},"404":{"description":"Not Found"}}},"delete":{"summary":"Remove your vote from a map","tags":["Votes"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Vote removed","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"Unauthorized"}}}},"/maps/{id}/comments":{"get":{"summary":"List comments on a map","tags":["Comments"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"List of comments","content":{"application/json":{"schema":{"type":"object","properties":{"comments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"user_id":{"type":"string"},"profile":{"type":"object","nullable":true,"properties":{"username":{"type":"string"},"display_name":{"type":"string","nullable":true},"avatar_url":{"type":"string","nullable":true}},"required":["username"]}},"required":["id","content","created_at","user_id"]}}},"required":["comments"]}}}},"401":{"description":"Unauthorized"}}},"post":{"summary":"Add a comment to a map","tags":["Comments"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","minLength":1,"maxLength":5000}},"required":["content"]}}}},"responses":{"201":{"description":"Comment created","content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"user_id":{"type":"string"},"profile":{"type":"object","nullable":true,"properties":{"username":{"type":"string"},"display_name":{"type":"string","nullable":true},"avatar_url":{"type":"string","nullable":true}},"required":["username"]}},"required":["id","content","created_at","user_id"]}},"required":["comment"]}}}},"400":{"description":"Error"},"401":{"description":"Unauthorized"},"403":{"description":"Map is not published"},"404":{"description":"Not Found"}}}},"/maps/{id}/comments/{commentId}":{"patch":{"summary":"Update a comment","tags":["Comments"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"commentId","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","minLength":1,"maxLength":5000}},"required":["content"]}}}},"responses":{"200":{"description":"Comment updated","content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"user_id":{"type":"string"},"profile":{"type":"object","nullable":true,"properties":{"username":{"type":"string"},"display_name":{"type":"string","nullable":true},"avatar_url":{"type":"string","nullable":true}},"required":["username"]}},"required":["id","content","created_at","user_id"]}},"required":["comment"]}}}},"400":{"description":"Error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}}},"delete":{"summary":"Delete a comment","tags":["Comments"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"commentId","in":"path"}],"responses":{"204":{"description":"No Content"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"}}}},"/users/{id}/follow":{"post":{"summary":"Follow a user","tags":["Users"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Already following","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"201":{"description":"Followed successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"400":{"description":"Error"},"401":{"description":"Unauthorized"}}},"delete":{"summary":"Unfollow a user","tags":["Users"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Unfollowed successfully","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"Unauthorized"}}}},"/virtual-users":{"get":{"summary":"List virtual users owned by the authenticated API key","tags":["Virtual Users"],"responses":{"200":{"description":"List of virtual users","content":{"application/json":{"schema":{"type":"object","properties":{"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"username":{"type":"string"},"display_name":{"type":"string","nullable":true},"avatar_url":{"type":"string","nullable":true},"created_at":{"type":"string"}},"required":["id","username"]}}},"required":["users"]}}}},"401":{"description":"Unauthorized"}}},"post":{"summary":"Create a virtual user","tags":["Virtual Users"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"username":{"type":"string","minLength":3,"maxLength":30,"pattern":"^[a-zA-Z0-9_-]+$"},"display_name":{"type":"string","minLength":1,"maxLength":50},"avatar_url":{"type":"string","format":"uri"}},"required":["username"]}}}},"responses":{"201":{"description":"Virtual user created","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string"},"username":{"type":"string"},"display_name":{"type":"string","nullable":true},"avatar_url":{"type":"string","nullable":true},"created_at":{"type":"string"}},"required":["id","username"]}},"required":["user"]}}}},"400":{"description":"Error"},"401":{"description":"Unauthorized"},"409":{"description":"Username already taken"}}}},"/virtual-users/{id}":{"patch":{"summary":"Update a virtual user","tags":["Virtual Users"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"type":"string","minLength":1,"maxLength":50},"avatar_url":{"type":"string","format":"uri"}}}}}},"responses":{"200":{"description":"Virtual user updated","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string"},"username":{"type":"string"},"display_name":{"type":"string","nullable":true},"avatar_url":{"type":"string","nullable":true},"created_at":{"type":"string"}},"required":["id","username"]}},"required":["user"]}}}},"400":{"description":"Error"},"401":{"description":"Unauthorized"},"404":{"description":"Not Found"}}},"delete":{"summary":"Delete a virtual user","tags":["Virtual Users"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"204":{"description":"No Content"},"401":{"description":"Unauthorized"},"404":{"description":"Not Found"}}}},"/auth/keys":{"get":{"summary":"List your API keys","tags":["API Keys"],"security":[{"cookieAuth":[]}],"responses":{"200":{"description":"List of API keys","content":{"application/json":{"schema":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"key_prefix":{"type":"string"},"created_at":{"type":"string"},"last_used_at":{"type":"string","nullable":true},"is_active":{"type":"boolean"},"tier":{"type":"string"}},"required":["id","name","created_at"]}}},"required":["keys"]}}}},"401":{"description":"Unauthorized"}}},"post":{"summary":"Create a new API key","tags":["API Keys"],"security":[{"cookieAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":50}},"required":["name"]}}}},"responses":{"201":{"description":"API key created","content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"key_prefix":{"type":"string"},"created_at":{"type":"string"},"last_used_at":{"type":"string","nullable":true},"is_active":{"type":"boolean"},"tier":{"type":"string"},"token":{"type":"string"}},"required":["id","name","created_at","token"]}},"required":["key"]}}}},"400":{"description":"Error"},"401":{"description":"Unauthorized"}}}},"/auth/keys/{id}":{"delete":{"summary":"Revoke an API key","tags":["API Keys"],"security":[{"cookieAuth":[]}],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"API key revoked","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"401":{"description":"Unauthorized"}}}}}}