guides

Copy a published guide (an id from find_guides) into a NEW private trip of the traveller's own — its places in the guide

Copy a published guide (an id from find_guides) into a NEW private trip of the traveller's own — its places in the guide's day order, with credit to the author. Places the traveller already saved are reused, not duplicated; a place the author published without a location is left out and counted, never guessed. A road-trip guide becomes a road trip. Not copied: the author's dates, budget, writing or photos. The plan limit applies.

post/actions/use_guide

Request

  • Base URL: https://findinghorizons.ca/api/v1
  • URL: https://findinghorizons.ca/api/v1/actions/use_guide
  • 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

guideIdstring required
titlestring

Name for the new trip (default: the guide's title)

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.