Publish match prediction

Developing

POST

https://uat-integration.returning.ai/apis/v1/match-predictions/{matchPredictionId}/publish

Match Predictions

Transition a draft match prediction to scheduled (or open if predictionStartAt has already passed).

Auth: Bearer API key with matchPredictions permission.
Validation: full configuration + permission references are validated. Any invalid field returns 400 MATCH_PREDICTION_VALIDATION_FAILED with details[].
Lifecycle: draft → scheduled → open (auto) → locked (auto, at lockAt) → settlement_in_progress. Publish on a non-draft match returns 409 INVALID_LIFECYCLE_TRANSITION.
Cross-community isolation: cross-community id returns 404 identical to unknown-id shape.
Rate limit + Freeze: standard.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200Published

application/json

Match prediction published; status is now scheduled or open.

Bodyapplication/json

🟠400Validation failed

🟠401Unauthorized

🟠403Forbidden

🟠404Not found

🟠409Conflict

🟠429Rate limited

🔴500Internal error

🔴503Frozen

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://uat-integration.returning.ai/apis/v1/match-predictions/mp_01abc/publish' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Published

{
  "meta": {
    "status": "success",
    "statusCode": 200,
    "code": "MATCH_PREDICTION_PUBLISHED",
    "requestId": "req_01abc",
    "timestamp": "2026-08-07T12:00:00.000Z"
  },
  "message": "Match prediction published.",
  "data": {
    "id": "mp_01abc",
    "status": "scheduled",
    "version": 2
  }
}

Modified at 2026-09-25 08:29:20

Patch match prediction

Settle match prediction