Patch match prediction

Developing

PATCH

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

Match Predictions

Version-guarded partial update. Send only fields that should change plus the last-read version.

Auth: Bearer API key with matchPredictions permission.
Version guard: version is required. Mismatch → 409 VERSION_CONFLICT. Successful PATCH increments version.
Immutable-after-publish rules: once published, schedule timestamps may never move earlier; team or reward changes after predictions exist → 409 LOCKED_FIELDS_IMMUTABLE.
Read-only fields: id, status, communityId, serverId, version (on body) must not be submitted.
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

Body Params application/jsonRequired

Examples

Responses

🟢200Patched

application/json

Match prediction updated. version is incremented.

Bodyapplication/json

🟠400Validation failed

🟠401Unauthorized

🟠403Forbidden

🟠404Not found

🟠409Conflict

🟠429Rate limited

🔴500Internal error

🔴503Frozen

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://adss-uat-integration.returning.ai/apis/v1/match-predictions/mp_01abc' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "version": 3,
  "title": "Australia vs New Zealand — Rugby World Cup Final"
}'

Response Example

200 - Patched

{
  "meta": {
    "status": "success",
    "statusCode": 200,
    "code": "MATCH_PREDICTION_PATCHED",
    "requestId": "req_01abc",
    "timestamp": "2026-08-07T12:00:00.000Z"
  },
  "message": "Match prediction updated.",
  "data": {
    "id": "mp_01abc",
    "status": "open",
    "version": 4
  }
}

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

Get match prediction

Publish match prediction