Roster

Upsert Roster

Changed on

Upsert roster entries (batch support).

For each entry:

  1. Resolve player_id: use provided value, look up by (team_id, jersey_number, season), or generate new UUID
  2. Upsert player_info (by player_id)
  3. Upsert player_jersey mapping (team_id + jersey_number + season -> player_id)
  4. Upsert roster entry
  5. Upsert team_roster (season + player_id -> team_id)

Important: When a player changes jersey number, you MUST provide player_id in the request. Otherwise the system cannot resolve the existing player (the new jersey has no prior mapping) and will create a duplicate player record. player_id is the canonical identity; jersey_number is only a roster attribute.

post/api/v1/roster

Request

  • Base URL
    https://developer.preciser.io
  • URL
    https://developer.preciser.io/api/v1/roster
  • Auth
    none declared. Required headers: x-api-key, League

Headers

x-api-keystring required

Required API key issued by Preciser.

Leaguestring required

Required tenant/database selector, for example pitchbio-master.

Request body

Example request

{
  "entries": [
    {
      "competition_id": "VIC",
      "jersey_number": 23,
      "player_name": "John Doe",
      "season": "2024-25",
      "team_id": "60959335-3173-45b4-b656-276a05b22011"
    },
    {
      "competition_id": "NSW",
      "jersey_number": 7,
      "player_id": "1b58990c-9591-49b6-951f-6b573a111583",
      "player_name": "Jane Smith",
      "season": "2024-25",
      "team_id": "60959335-3173-45b4-b656-276a05b22011"
    }
  ]
}

Response

Successful Response

successboolean required

Whether the operation was successful

messagestring required

Status message

Changes

  • 9b0abde08b06Revision changes
    • breaking

      the header request parameter League became required

    • breaking

      the header request parameter x-api-key became required

    • breaking

      header request parameter League list-of-types was narrowed by removing types null

    • breaking

      header request parameter x-api-key list-of-types was narrowed by removing types null

    • info

      for the header request parameter League, the type was generalized from no type to string

    • info

      for the header request parameter x-api-key, the type was generalized from no type to string

  • 64853d21435bRevision changes
    • info

      added the new optional request property //

    • info

      added the optional property // to the response with the status

    • info

      added the required property // to the response with the status