Skip to main content
POST
/
game-sessions
/
{session_id}
/
move
Submit move
curl --request POST \
  --url https://api.spikelabs.com/v1/game-sessions/{session_id}/move \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "move": {},
  "message": "<string>"
}
'
{
  "session": {
    "id": "gs_abc123",
    "object": "game_session",
    "game_id": "<string>",
    "personality_id": "<string>",
    "status": "waiting",
    "created_at": "2023-11-07T05:31:56Z",
    "user_id": "<string>",
    "current_turn": "user",
    "state": {},
    "winner": "user",
    "move_count": 123,
    "personality_commentary": "<string>",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "user_move_valid": true,
  "user_move_error": "<string>",
  "personality_move": {},
  "personality_message": "<string>"
}

Authorizations

Authorization
string
header
required

API key authentication. Use your secret key (starts with sk_) as a Bearer token.

Path Parameters

session_id
string
required

Body

application/json
move
object
required

Game-specific move data

message
string

Optional message to the personality

Response

Move result

session
object
required
user_move_valid
boolean
required
user_move_error
string | null
personality_move
object
personality_message
string | null

Personality's response/commentary