Authentication

This API uses Laravel Sanctum for authentication. Include your bearer token in the Authorization header.

Authorization Header
Authorization: Bearer YOUR_TOKEN
GET /user Get authenticated user ▼

Authorization

🔒 Bearer Token Required

Responses

200 Success
401 Unauthorized

Characters

GET /characters List all characters ▼

Returns all characters belonging to the authenticated user.

🔒 Auth Required
POST /characters Create a character ▼
🔒 Auth Required
GET /characters/{id} Get specific character ▼

Parameters

idintegerpathCharacter ID
PUT /characters/{id} Update character ▼
🔒 Auth Required
DELETE /characters/{id} Delete character ▼
🔒 Auth Required
POST /characters/{id}/share Generate share token ▼

Generate a shareable token for this character.

GET /characters/shared/{token} Access shared character ▼

Access a character via share token.

Animons

GET /animons List all Animons ▼
🔒 Auth Required
POST /animons Create Animon ▼
🔒 Auth Required
POST /animons/generate Generate random Animon ▼

Generate a random Animon with AI-assisted stats.

🔒 Auth Required
GET /animons/{id} Get Animon ▼
🔒 Auth Required
PUT /animons/{id} Update Animon ▼
🔒 Auth Required
DELETE /animons/{id} Delete Animon ▼
🔒 Auth Required
POST /animons/{id}/validate Validate Animon stats ▼
🔒 Auth Required
POST /animons/{id}/calculate-stats Calculate derived stats ▼

Calculate HP, damage, and other derived statistics.

Evolution Stages

GET /animons/{id}/evolution-stages List evolution stages ▼
🔒 Auth Required
POST /animons/{id}/evolution-stages Create evolution stage ▼
🔒 Auth Required
GET /animons/{id}/evolution-stages/{stageId} Get evolution stage ▼
🔒 Auth Required
PUT /animons/{id}/evolution-stages/{stageId} Update evolution stage ▼
🔒 Auth Required
DELETE /animons/{id}/evolution-stages/{stageId} Delete evolution stage ▼
🔒 Auth Required
GET /evolution-stages/random-attack-name Generate attack name ▼

Generate a random attack name.

GET /evolution-stages/options Get evolution options ▼

Get available options (elements, types, etc.)

Humans (Kids)

GET /humans List all humans ▼
🔒 Auth Required
POST /humans Create human ▼
🔒 Auth Required
POST /humans/generate Generate random human ▼

Generate a random human character.

GET /humans/{id} Get human ▼
🔒 Auth Required
PUT /humans/{id} Update human ▼
🔒 Auth Required
DELETE /humans/{id} Delete human ▼
🔒 Auth Required
POST /humans/{id}/validate Validate human stats ▼
🔒 Auth Required

Character Pairs

GET /pairs List all pairs ▼
🔒 Auth Required
POST /pairs Create pair ▼
🔒 Auth Required
GET /pairs/{id} Get pair ▼
🔒 Auth Required
DELETE /pairs/{id} Delete pair ▼
🔒 Auth Required

Virtual Tabletop

GET /tabletop/rooms List rooms ▼
🔒 Auth Required
POST /tabletop/rooms Create room ▼
🔒 Auth Required
GET /tabletop/rooms/{id} Get room ▼
🔒 Auth Required
PUT /tabletop/rooms/{id} Update room ▼
🔒 Auth Required
DELETE /tabletop/rooms/{id} Delete room ▼
🔒 Auth Required
POST /tabletop/rooms/{id}/join Join room ▼
🔒 Auth Required
POST /tabletop/rooms/{id}/leave Leave room ▼
🔒 Auth Required
POST /tabletop/rooms/{id}/state Update game state ▼

Update positions, HP, and other battle data.

Collaboration Sessions

GET /sessions List sessions ▼
🔒 Auth Required
POST /sessions Create session ▼
🔒 Auth Required
POST /sessions/code/{code}/join Join by code ▼

Parameters

codestringpathSession code
GET /sessions/{id} Get session ▼
🔒 Auth Required
PUT /sessions/{id} Update session ▼
🔒 Auth Required
DELETE /sessions/{id} Delete session ▼
🔒 Auth Required

File Uploads

POST /upload/avatar Upload avatar ▼

Upload character avatar. Content-Type: multipart/form-data

🔒 Auth Required
DELETE /upload/avatar Delete avatar ▼
🔒 Auth Required
POST /upload/tabletop/background Upload background ▼

Upload tabletop background. Content-Type: multipart/form-data

Broadcasting / WebSocket

POST /broadcast/character-update Broadcast character update ▼

Broadcast character updates via WebSocket.

POST /broadcast/session-join Broadcast session join ▼

Broadcast when user joins session.

POST /broadcast/room-update Broadcast room state ▼

Broadcast room state changes.