---
title: "Plan a group SPLIT for the live day: given who goes in which subgroup (and optionally where each subgroup is), returns p"
method: POST
path: "/actions/trip_split_mode"
tags: ["live"]
---

# Plan a group SPLIT for the live day: given who goes in which subgroup (and optionally where each subgroup is), returns p

`POST /actions/trip_split_mode`

## Request

- Base URL: `https://findinghorizons.ca/api/v1`
- URL: `https://findinghorizons.ca/api/v1/actions/trip_split_mode`
- Auth: OAuth 2 (authorization code, authorization URL `https://findinghorizons.ca/api/mcp/authorize`, token URL `https://findinghorizons.ca/api/mcp/oauth/token`, scopes: `trips:read`)

Plan a group SPLIT for the live day: given who goes in which subgroup (and optionally where each subgroup is), returns per-subgroup allowed/blocked saved places (each subgroup constrained only by its OWN members' stated no-gos from trip_member_prefs), the reconvene anchor (the day's next locked/protected stop), and a leave-by per subgroup with a 15-min margin. Travel is a walking estimate from straight-line distance unless you pass travelMinutesToAnchor. Read-only; writes nothing.

## Request body

- object
  - `tripId` string, required: Trip id from get_my_trips
  - `nowMs` number, required: Epoch ms of the travellers' NOW.
  - `subgroups` object[], required: Two or more subgroups covering the people splitting.
    - `name` string, required
    - `memberIds` string[], required: User ids (trip members).
    - `lat` number
    - `lng` number
    - `travelMinutesToAnchor` number: Measured minutes to the anchor, if you have them.
  - `today` string: The traveller's own date, YYYY-MM-DD, where the action needs one

## Response `200`

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

## Other responses

- `400`: Bad body / missing Idempotency-Key
- `401`: No or invalid token
- `403`: Scope not granted
- `422`: The action said no
- `429`: Rate limited

---

[API](https://skmtc.dev/findinghorizons/apis/finding-horizons-api.md) · [All operations](https://skmtc.dev/findinghorizons/apis/finding-horizons-api/llms.txt) · [OpenAPI document](https://skmtc.dev/findinghorizons/apis/finding-horizons-api/revisions/e347f6070173?raw)