roadtrips

Save a road trip as a real, private trip — the drive Horizon works out for these inputs (the same as propose_road_trip;

Save a road trip as a real, private trip — the drive Horizon works out for these inputs (the same as propose_road_trip; it is worked out again here, never taken from your copy), with the way home: "mirror" (drive back the same way), "fly" (an unbooked flight home) or "keep_going" (the trip ends there). Dates YYYY-MM-DD are optional. The plan limit of their subscription applies.

post/actions/save_road_trip

Request

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

Headers

Idempotency-Keystring required

One per intended change; a repeat never runs twice.

X-FH-Taskstring

Your task reference.

Request body

startstring required

Where the drive starts (a town or city)

destinationstring required
stopsstring[]

Optional places on the way, in order

driversnumber

1, 2 or 3 people who drive

pace'relaxed' | 'balanced' | 'sooner'

relaxed ≤6 h at the wheel a day · balanced ≤8 h · sooner ≤10 h

backRoadsboolean

Avoid motorways (slower, scenic)

titlestring
startDatestring
endDatestring
wayHome'mirror' | 'fly' | 'keep_going' required
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.