Skip to content
FoxLeague Manual

Set or clear your coach name

POST
/api/teams/coach
 
curl --request POST \
  --url https://foxleague.ai/api/teams/coach \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "coach_name": "example" }'

Sets the coach name shown on your team and answers the team. An empty value clears it.

Who: a signed-in player with a team.

Refusals:

  • Coach name must be 20 characters or fewer: the trimmed name is longer than 20 characters.
  • Only letters, numbers, spaces, hyphens and dots allowed: the name holds another character.
  • User not found: the wallet has no account.
  • Team not found: the wallet has no team.
  • Your coach name is saved. Reload the page to see it.: the name is saved but the team could not be read back.

If the name cannot be saved on our side, the answer is HTTP 500 with an empty body.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
Media type application/json

The coach name to show on your team.

object
coach_name
required

The coach name: up to 20 characters among letters, numbers, spaces, hyphens and dots. An empty value clears it.

string
Example generated
{
  "coach_name": "example"
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Success or a refusal: read success (the refusals are in the description).

Media type application/json
object
code

A machine-readable reason next to error, set only where the caller must act differently. tx_pending: the payment was not refused but could not be verified yet; keep the transaction hash and confirm again with the same hash, never pay twice.

string | null
data

The answer. Present when success is true.

object
badge

The team badge, usually an ipfs:// address (some older teams carry an inline image); null when none.

string | null
badge_ipfs_uri

The badge’s ipfs:// address; null when none.

string | null
best_xi_by_formation
required

The best XI of every formation the team can pick, best first (equal ones in the order of the formation list): its first entry is best_xi_ovr in best_xi_formation. Empty when no card it owns fits a slot.

Array<object>

The best XI of one formation.

object
complete
required

false when the cards cannot fill that formation: the OVR is then the average of the cards it holds.

boolean
formation
required

A formation a team can pick in Tactics, as a Team.formation id such as 4-3-3.

string
ovr
required

The best XI OVR in that formation, one decimal.

number format: double
best_xi_formation

The formation that best XI is built in, such as 4-3-3. null with best_xi_ovr.

string | null
best_xi_ovr

The team’s OVR, one decimal: its best XI OVR, the average OVR of the strongest XI it can field from the cards it owns now (for every formation in Tactics the best card of each position for its slots, each card in its own position, the highest average kept; cards listed for sale count). No lineup choice moves it. The same number every page and the OVR range use. null when no card it owns fits a slot.

number | null format: double
coach_name

The coach name; null when not set.

string | null
created_at
required

When the team was created (RFC 3339).

string format: date-time
formation
required

The saved formation.

string
id
required

Team id.

integer format: int32
lineup
required

NFT nonces of the 11 starters, as an array. Empty until a lineup is saved.

name
required

Team name.

string
substitutes
required

NFT nonces of the bench, as an array.

user_id
required

The owner’s user id.

integer format: int32
verified
required

true when the team carries the verified mark.

boolean
error

Why the request was refused, in plain words. Present when success is false.

string | null
success
required

true when the request did what it asked. false is a refusal: read error.

boolean
Example 
{
  "data": {
    "badge": "ipfs://bafybeihkoviema7g3gxyt6la7vd5ho32ictqbilu3wnlo3rs7ewhnp7lly",
    "badge_ipfs_uri": "ipfs://bafybeihkoviema7g3gxyt6la7vd5ho32ictqbilu3wnlo3rs7ewhnp7lly",
    "best_xi_by_formation": [
      {
        "complete": true,
        "formation": "4-3-3",
        "ovr": 52.6
      },
      {
        "complete": true,
        "formation": "4-3-3w",
        "ovr": 52.6
      },
      {
        "complete": true,
        "formation": "4-3-3b",
        "ovr": 52.6
      },
      {
        "complete": true,
        "formation": "4-4-2",
        "ovr": 52.1
      },
      {
        "complete": true,
        "formation": "4-4-2o",
        "ovr": 52.1
      },
      {
        "complete": true,
        "formation": "4-2-3-1",
        "ovr": 51.8
      },
      {
        "complete": true,
        "formation": "5-3-2",
        "ovr": 51.3
      },
      {
        "complete": true,
        "formation": "5-2-3",
        "ovr": 50.9
      }
    ],
    "best_xi_formation": "4-3-3",
    "best_xi_ovr": 52.6,
    "coach_name": "Ada Moraru",
    "created_at": "2026-09-16T08:02:44.517093Z",
    "formation": "4-3-3",
    "id": 398,
    "lineup": [
      1301,
      1234,
      1240,
      1255,
      1262,
      1270,
      1288,
      1290,
      1302,
      1311,
      1325
    ],
    "name": "Fox Rovers",
    "substitutes": [
      1330,
      1342,
      1356,
      1361,
      1377,
      1389,
      1394
    ],
    "user_id": 412,
    "verified": false
  },
  "success": true
}

401

Section titled “401 ”

No valid session. The body is plain text: Missing Authorization header, Invalid Authorization format, Invalid session token or Session expired or invalid. Sign in again.

Media type text/plain
string
Example 
Session expired or invalid

500

Section titled “500 ”

The coach name could not be saved on our side. The body is empty.