Match Cancel

This event is sent to the Game in case a match has been, for any reason, cancelled on the Faceit side. The Game is responsible to dispatch it to all game clients. It can be sent at any time after the Match Configuration event.

The request payload, in case of a POST or PUT request, will contain extra info such as match details, cancellation reason and so on.

Endpoint Specifications

Payload overview

The JSON schema of the match cancel payload can be found here.

A sample payload for a match cancelled by an admin is the following:

{
  "match_id": "1234-5678",
  "game": "tic-tac-toe",
  "cancellation_reason_code": "CANCEL-REASON-001"
}

Field Descriptions

Request Payload

Field	Type	Description
match_id	String	The FACEIT unique identifier of the match instance.
game	String	The identifier of the game title.
cancellation_reason_code	String	The reason why the match was cancelled. Currently only CANCEL-REASON-001 code is available (cancelled by a FACEIT admin).

Response Codes and Errors

HTTP Codes	Description
2xx	Match cancel call will be considered successful.
4xx	Match cancel call will be considered failed.
5xx	Match cancel call will be considered failed.