tasks

Attach your task to one of the traveller's trips — the same conversation Horizon has on that trip — or update it

Attach your task to one of the traveller's trips — the same conversation Horizon has on that trip — or update it. Keep ONLY: the intent, explicit decisions the traveller made, constraints they set, and open questions. Never a transcript or private details. Horizon sees these and continues from them; get_task tells you what Horizon or the traveller changed since.

post/actions/continue_task

Request

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

Headers

Idempotency-Keystring required

One per intended change; a repeat never runs twice.

X-FH-Taskstring

Your task reference.

Request body

taskRefstring required

Your own reference for this task (e.g. your conversation id). One task per trip.

tripIdstring required
intentstring

One sentence: what the traveller wants.

decisionsstring[]

Up to 20 short decisions the traveller made ("keep Kyoto separate").

constraintsstring[]

Up to 20 constraints ("two free evenings").

pendingQuestionsstring[]

Up to 20 open questions.

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.