gameplay

WRITE: turn one of today's challenges into an accepted detour on the trip route

WRITE: turn one of today's challenges into an accepted detour on the trip route. Double-gated exactly as in the app: the trip's allow_detours switch AND the traveller's own detour preference must both be on, otherwise it is refused and the blocking gate is named. The challenge is re-derived server-side for the date and must be on that day's list.

post/actions/accept_challenge

Request

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

Headers

Idempotency-Keystring required

One per intended change; a repeat never runs twice.

X-FH-Taskstring

Your task reference.

Request body

tripIdstring required
challengeIdstring required

id from get_daily_challenges

datestring required

The same calendar date the challenge was listed for, YYYY-MM-DD

detourPreferenceEnabledboolean

The traveller's own detour preference. Omit and it is treated as OFF.

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.