WIwithmedley
MatchingSessions

Create a matching session for a cohort (leg A)

Always creates a new matching_sessions row for the calling admin (1:N model -- spec §14 step 6). If the cohort has an active matching attempt with another admin, the new row joins it via the existing external_session_id and matching-server is asked to re-mint a navigation token. Otherwise a fresh session is created on matching-server with the full §9.1 payload.

Per §11.7 SGOS does NOT retry leg (C) automatically. On any failure the row's status transitions to failed; the admin retries by clicking the button again (which creates a new row).

post/api/cohorts/{cohortId}/matching-sessions

Request

  • Base URL
    https://api.production.yourmedley.com
  • Auth
    HTTP bearer

Path parameters

cohortIdstring uuid required

Request body

object required

Response

Session created (create-mode) or joined an existing attempt (re-mint mode).

session_idstring uuid required

SGOS's matching_sessions.id for the new row owned by the calling admin

matching_urlstring uri required

matching-server URL with a single-use navigation token (leg D entrypoint)

Changes

No recorded changes to this operation across all 1 revision of this API.