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

data_uristring required

Response

Successful Response

Changes

No recorded changes to this operation across all 50 revisions of this API.