Achievements
Update Achievement
Update one or more fields of an existing achievement. Only the fields you send are changed — omitted fields keep their current values.
POST
/api/achievements/update.php
Requires
Authorization: AppID:AppKey headerRequest body
| Field | Type | Required | Description |
|---|---|---|---|
| slug | string | required | Identifies the achievement to update |
| name | string | optional | New display name |
| description | string | optional | New description |
| icon | string | optional | New icon URL |
| rarity | string | optional | common, uncommon, rare, epic, legendary |
| xp | int | optional | New XP value |
| secret | bool | optional | Toggle secret status |
Test this endpoint
Headers
Body
Success response 200
{
"success": true,
"achievement": {
"id": 1,
"app_id": "com.myapp.game",
"slug": "first_kill",
"name": "First Kill",
"rarity": "uncommon",
"xp": 200,
"secret": false
}
}Errors
| Code | Message | Cause |
|---|---|---|
| 400 | slug is required. | Missing identifier |
| 404 | Achievement not found. | Slug doesn't exist for this app |