user-events

Create User Event

Create or update a user's association with an event.

  • Catalog attach (event_id provided): looks up the existing Event and attaches via UserEvent.attach.
  • Prefilled attach (no event_id): materializes an Event(data_quality=prefilled) from the prefilled payload, attaches, and dispatches a DiscoverySession(prefilled_confirm) so the discovery worker enriches it asynchronously.

replace_existing (default True) preserves the legacy single-goal flow that old mobile builds depend on — every other planned/active row is cancelled before the new one is inserted. Calendar-aware clients send False to append.

post/user_events

Query parameters

user_idstring nullable

Request body

event_idstring nullable
discipline_namestring required
distance_kmnumber required
sport_typestring required
elevation_gain_minteger nullable
start_timestring nullable
intentstring nullable
replace_existingboolean
namestring nullable
citystring nullable
countrystring nullable
approximate_datestring date nullable
descriptionstring nullable

Response

Successful Response

object required

Changes

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