Maps
Upload Og Image
Upload a base64 OG social-card image (up to 750KB) for a map.
Accepts a data:image/ URI, decodes the base64 payload, validates the bytes are a real image (PIL verify), writes to storage under maps/og-images/{map_id}.{ext}, and persists the storage key to catalog.maps.og_image_uri.
Intended for 1200x630 JPEG captures. The payload cap (750KB) is larger than the thumbnail cap (100KB) to accommodate the larger canvas export — they are separate schemas (OgImageUploadRequest vs ThumbnailUploadRequest) to avoid relaxing the locked thumbnail contract. Auth and PIL-verify rules are identical to upload_thumbnail.
put/maps/{map_id}/og-image/
Request
- The document declares no server URL.
- Auth: one of:
- OAuth 2 (password, token URL /api/auth/login)
- API key in header X-Api-Key
- API key in query parameter api_key
Path parameters
map_idstring uuid required
Request body
Response
Successful Response
Changes
No recorded changes to this operation across all 50 revisions of this API.