Matches

Release a match

Releases the current user's active claim on the match (status becomes released and released_at is stamped) AND hands the match back to the pool: an in_progress match transitions back to pending so another scorer can claim it, which also frees the court for the next match on the game and drops this match from the game's live score channel. A completed match keeps its status.

The scoring event log, match_rounds and score_entries all survive, so the next claimer resumes the match via start_scoring rather than restarting it.

Idempotent: when the user holds no active claim the response is still 204 and neither the match nor anyone else's claim is touched, so a client retry after a timed-out-but-successful release is safe.

patch/v1/matches/{id}/release

Request

  • Base URL
    https://api.hify.club
  • Auth
    API key in header X-User-Token

Request body

Response

Claim released (or no active claim to release — see idempotency)

Changes

No recorded changes to this operation across all 2 revisions of this API.