places

WRITE: put places YOU suggested in this conversation on the traveller's map, when they ask you to plot or save them ("pl

WRITE: put places YOU suggested in this conversation on the traveller's map, when they ask you to plot or save them ("plot those", "add them to my map"). Give each place's name plus its city and country. A place the Finding Horizons community has already verified is saved at once, free, with your name kept as its source. A place nobody has verified yet is returned in needsImport: send each through import_from_url with text "<name>, <city>, <country>" — never invent coordinates. Already-saved places come back in alreadySaved. To add the plotted places to a trip afterwards, use update_trip_stops with their ids.

post/actions/plot_places

Request

  • Base URL: https://findinghorizons.ca/api/v1
  • URL: https://findinghorizons.ca/api/v1/actions/plot_places
  • Auth: OAuth 2 (authorization code, authorization URL https://findinghorizons.ca/api/mcp/authorize, token URL https://findinghorizons.ca/api/mcp/oauth/token, scopes: places:write)

Headers

Idempotency-Keystring required

One per intended change; a repeat never runs twice.

X-FH-Taskstring

Your task reference.

Request body

todaystring

The traveller's own date, YYYY-MM-DD, where the action needs one

expectedVersioninteger

For a change to a trip: the planVersion you last read

Response

Done — { ok, api, action, result, card, operation? }

Changes

No recorded changes to this operation across all 1 revision of this API.