Sign in
Maps

Update Map Share Token Endpoint

Update expiration on an existing share token. Owner or admin only.

A fixed-day preset is always available. Null clears expiration.

patch/maps/{map_id}/share/

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

expires_atstring date-time nullable

Expiration timestamp; must carry a UTC offset. Null creates a non-expiring share link. A custom expiration requires advanced sharing controls.

expires_in_days1 | 7 | 30 | 90 nullable

Server-calculated expiration preset. Choose 1, 7, 30, or 90 days.

Response

Successful Response

tokenstring required

Raw token on create, hint on retrieve

share_urlstring nullable

Full shareable URL — only returned on create

expires_atstring date-time nullable
is_activeboolean

Changes

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