Skip to main content
POST
Create league submission

Authorizations

Authorization
string
header
required

Bearer token issued by Softmax

Body

application/json
league_id
string
required

League receiving the submission.

Pattern: ^league_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
policy_version_id
string<uuid>
required

Policy version to submit.

player_id
string | null

Player credited for the submission, or null to use the policy owner's player.

Pattern: ^ply_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
auto_champion
enum<string>
default:always

Controls whether newer versions of this policy become the player's league champion.

Available options:
always,
never,
lineage
preferences
Preferences · object | null

League-specific submission preferences.

notes
string | null

Note attached to the submission.

Response

Successful Response

id
string
required

Submission ID.

status
enum<string>
required

Current submission state.

Available options:
pending,
processing,
placed,
rejected,
withdrawn
league
LeaguePublic · object
required

League receiving the submission.

policy_version
PolicyVersionPublic · object
required

Policy version submitted to the league.

player
PlayerPublic · object | null
required

Player credited for the submission, or null when none is assigned.

created_at
string<date-time>
required

Time when the submission was created.

auto_champion
enum<string>
default:always

Controls whether newer versions of this policy become the player's league champion.

Available options:
always,
never,
lineage
preferences
Preferences · object | null

League-specific submission preferences.

notes
string | null

Note attached to the submission.

league_policy_membership_id
string | null

Membership created from the submission, or null until placement succeeds.