# Formations

Formations from the Formation Display tool.

- `type`: `normal`, `finalRestrictionRelease` or `tacticalRelay`.
- `strikers` / `specials`: slots in order; an empty object is an empty
  slot. Each slot takes `studentId`, `starter`, `starterOrder`,
  `starLevel` (1–5), `ueLevel` (1–4), `borrowed` and `level`.
- `rows`: optional extra rows for multi-team modes, each with `strikers`,
  `specials`, optional `tcs` and an optional `label`.
- `name` is 1–100 characters.

Authentication: Bearer Token — `Authorization: Bearer <token>` (inherited from folder "Your data")

## Contents

- [List formations](https://ba.joexyz.online/developers/reference/your-data/formations/list-formations.md): Lists your formations, newest first.
- [Create a formation](https://ba.joexyz.online/developers/reference/your-data/formations/create-a-formation.md): Creates a formation and returns it.
- [Get a formation](https://ba.joexyz.online/developers/reference/your-data/formations/get-a-formation.md): Gets one of your formations.
- [Update a formation](https://ba.joexyz.online/developers/reference/your-data/formations/update-a-formation.md): Updates a formation and returns it.
- [Delete a formation](https://ba.joexyz.online/developers/reference/your-data/formations/delete-a-formation.md): Deletes a formation.
