Skip to main content
PATCH
Update player game progress

Path Parameters

id
string
required

Player UUID

Body

application/json
xp
number

Player XP

Required range: x >= 0
Example:

1500

level
number

Player level

Required range: x >= 1
Example:

10

lives
number

Player lives/energy

Required range: x >= 0
Example:

3

maxLives
number

Maximum lives

Required range: x >= 1
Example:

5

currencies
object

Player currencies (key-value pairs)

Example:

Response

Player progress updated successfully

id
string
required

Unique player identifier

Example:

"123e4567-e89b-12d3-a456-426614174000"

projectId
string
required

Project ID this player belongs to

Example:

"123e4567-e89b-12d3-a456-426614174000"

externalUserId
string
required

External user ID from client application

Example:

"user_12345"

xp
number
required

Player XP

Example:

1250

level
number
required

Player level

Example:

5

lives
number
required

Current lives/energy

Example:

3

maxLives
number
required

Maximum lives

Example:

5

livesUpdatedAt
string<date-time>
required

Last time lives were updated

Example:

"2025-01-15T10:30:00Z"

currencies
object
required

Player currencies (key-value pairs)

Example:
status
enum<string>
required

Player status

Available options:
ACTIVE,
SUSPENDED,
BANNED
Example:

"ACTIVE"

isFlagged
boolean
required

Whether player is flagged for review

Example:

false

createdAt
string<date-time>
required

Creation timestamp

Example:

"2025-01-15T10:30:00Z"

updatedAt
string<date-time>
required

Last update timestamp

Example:

"2025-01-15T10:30:00Z"

lastSeenAt
string<date-time>
required

Last activity timestamp

Example:

"2025-01-15T10:30:00Z"

displayName
object

Player display name

Example:

"John Doe"

avatarUrl
object

Player avatar URL

Example:

"https://example.com/avatars/johndoe.png"

locale
object

Player locale

Example:

"en-US"

flagReason
object

Reason for flagging

Example:

null

metadata
object

Additional player metadata

Example:
deletedAt
object

Soft deletion timestamp

Example:

null