Your data / Rosters
PATCH
https://ba.joexyz.online/api/v1/me/rosters/:idhttp://localhost:3000/api/v1/me/rosters/:idUpdates a roster and returns it. Fields you leave out keep their current values.
Parameters
id(path): The roster id.
Authentication
Bearer Token — send Authorization: Bearer <token>. Inherited from folder "Your data".
Path parameters
| Name | Value |
|---|---|
| id |
Headers
| Name | Value |
|---|---|
| Content-Type | application/json |
Bodyapplication/json
{
"students": [
{
"studentId": "hoshino_battle_dealer",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 2,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino_swimsuit",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"featuredBorrowSlot": "jfd",
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 64,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
}
]
}curl -X PATCH https://ba.joexyz.online/api/v1/me/rosters/:id \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {{api_key}}' \
--data-raw '{
"students": [
{
"studentId": "hoshino_battle_dealer",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 2,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino_swimsuit",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"featuredBorrowSlot": "jfd",
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 64,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
}
]
}'const response = await fetch("https://ba.joexyz.online/api/v1/me/rosters/:id", {
method: "PATCH",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {{api_key}}",
},
body: JSON.stringify({
"students": [
{
"studentId": "hoshino_battle_dealer",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 2,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino_swimsuit",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"featuredBorrowSlot": "jfd",
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 64,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
}
]
}),
});
const data = await response.json();
console.log(data);import requests
url = "https://ba.joexyz.online/api/v1/me/rosters/:id"
headers = {
"Authorization": "Bearer {{api_key}}",
}
payload = {
"students": [
{
"studentId": "hoshino_battle_dealer",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4,
},
{
"studentId": "hoshino",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 2,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4,
},
{
"studentId": "hoshino_swimsuit",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"featuredBorrowSlot": "jfd",
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 64,
"starLevel": 5,
"sub": 10,
"ueLevel": 4,
},
],
}
response = requests.patch(url, headers=headers, json=payload)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{
"students": [
{
"studentId": "hoshino_battle_dealer",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 2,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino_swimsuit",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"featuredBorrowSlot": "jfd",
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 64,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
}
]
}`)
req, err := http.NewRequest("PATCH", "https://ba.joexyz.online/api/v1/me/rosters/:id", body)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer {{api_key}}")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
fmt.Println(string(data))
}curl -X PATCH http://localhost:3000/api/v1/me/rosters/:id \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {{api_key}}' \
--data-raw '{
"students": [
{
"studentId": "hoshino_battle_dealer",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 2,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino_swimsuit",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"featuredBorrowSlot": "jfd",
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 64,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
}
]
}'const response = await fetch("http://localhost:3000/api/v1/me/rosters/:id", {
method: "PATCH",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer {{api_key}}",
},
body: JSON.stringify({
"students": [
{
"studentId": "hoshino_battle_dealer",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 2,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino_swimsuit",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"featuredBorrowSlot": "jfd",
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 64,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
}
]
}),
});
const data = await response.json();
console.log(data);import requests
url = "http://localhost:3000/api/v1/me/rosters/:id"
headers = {
"Authorization": "Bearer {{api_key}}",
}
payload = {
"students": [
{
"studentId": "hoshino_battle_dealer",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4,
},
{
"studentId": "hoshino",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 2,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4,
},
{
"studentId": "hoshino_swimsuit",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"featuredBorrowSlot": "jfd",
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 64,
"starLevel": 5,
"sub": 10,
"ueLevel": 4,
},
],
}
response = requests.patch(url, headers=headers, json=payload)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{
"students": [
{
"studentId": "hoshino_battle_dealer",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 2,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino_swimsuit",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"featuredBorrowSlot": "jfd",
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 64,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
}
]
}`)
req, err := http.NewRequest("PATCH", "http://localhost:3000/api/v1/me/rosters/:id", body)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer {{api_key}}")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
fmt.Println(string(data))
}Response
{
"data": {
"id": "k17fp61xb5wqf8f6ge798sa1t17sg20f",
"createdAt": "2025-10-15T00:22:23.815Z",
"name": "Joe",
"accountLevel": 90,
"friendCode": "KQZRTVMW",
"gameServer": "EU",
"introduction": "Hello.\n\n**Note:** This isn't my full roster. Let me know if there's anyone in particular that you're looking for.",
"lastUpdated": 1783978245235,
"studentRepId": "kei",
"students": [
{
"studentId": "hoshino_battle_dealer",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 2,
"ex": 5,
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 74,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
},
{
"studentId": "hoshino_swimsuit",
"attackLevel": 25,
"basic": 10,
"enhanced": 10,
"equipmentSlot1": 10,
"equipmentSlot2": 10,
"equipmentSlot3": 10,
"equipmentSlot4": 0,
"ex": 5,
"featuredBorrowSlot": "jfd",
"healLevel": 25,
"hpLevel": 25,
"level": 90,
"relationshipRank": 64,
"starLevel": 5,
"sub": 10,
"ueLevel": 4
}
],
"visibility": "public"
}
}