fantasy

Save my current NBA Fantasy roster

Saves the squad you own, which of the two games you play it in, the scoring system, the season-long league contract, an optional court override per player and the day you spent the Captain chip. The league contract is versioned with the squad, so editing a slot moves the revision exactly like a transfer does. Names are resolved against the season player index with the same accent-insensitive matcher the website uses, and a name that cannot be placed with certainty is refused with that name in the message rather than guessed at. The response carries a revision that moves only when the stored content changes, so a retry is safe. This changes Predixsport private state only: it never signs in to ESPN, Yahoo, Sleeper or the NBA game and never submits a lineup anywhere. Requires mcp:read and fantasy:nba:write. The NBA fantasy workspace is a public beta. When the operator narrows it to a private trial, this endpoint answers 403 for an account outside it.

put/v1/fantasy/nba/me/roster

Request

  • Base URL: https://api.predixsport.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.predixsport.com/v1/fantasy/nba/me/roster
  • Auth: none declared

Headers

authorizationstring nullable

Request body

seasonstring required
preset'espn_points' | 'yahoo_9cat' | 'sleeper_points' | 'nba_salary_cap'

The scoring system this squad is played in. Omitted on an update = the saved one is kept (nba_salary_cap for a first save).

mode'salary_cap' | 'season_long' nullable

Which game this squad is played in: 'salary_cap' is the official NBA game, 'season_long' an ESPN-like points league. Omitted on an update = the saved one is kept; on a first save the scoring system decides.

chip_used_onstring date nullable

The day the owner spent the Captain chip this Gameweek. Null means it is still available. Omitted on an update = the saved day is kept, so resending the squad never revives a spent chip.

Response

Successful Response

seasonstring required
preset'espn_points' | 'yahoo_9cat' | 'sleeper_points' | 'nba_salary_cap'

The scoring system this squad is played in. Omitted on an update = the saved one is kept (nba_salary_cap for a first save).

mode'salary_cap' | 'season_long' nullable

Which game this squad is played in: 'salary_cap' is the official NBA game, 'season_long' an ESPN-like points league. Omitted on an update = the saved one is kept; on a first save the scoring system decides.

chip_used_onstring date nullable

The day the owner spent the Captain chip this Gameweek. Null means it is still available. Omitted on an update = the saved day is kept, so resending the squad never revives a spent chip.

revisioninteger required

Increments only when the saved content changes, so an identical save is idempotent and does not move it.

updated_atstring date-time nullable
changedboolean nullable

Whether this write changed the stored squad.

Changes

No recorded changes to this operation across all 1 revision of this API.