Overview
POST/gamification/replaygamification

Retroactively backfill awards a subject’s telemetry already earned (admin) — `{ecosystemId}` replays the whole realm, `{subjectType, subjectId, ecosystemId}` replays one subject

Create a record in replay.

Auth: bearerAuth — calls run as the authenticated user.

Request body

application/json · optional

  • ecosystemIdstring

    The target realm to replay

  • subjectTypeoptionalstring

    With subjectId, replay just this one subject instead of the whole realm

  • subjectIdoptionalstring

    Must be provided together with subjectType

Example
{
  "ecosystemId": "string",
  "subjectType": "string",
  "subjectId": "string"
}
Responses
200

Replay result

  • subjectsinteger

    Subjects touched (1 for a single-subject replay)

  • badgesinteger

    Newly-granted badges across the replayed subject(s)

  • xpGainedoptionalinteger

    Points granted — single-subject replay only

Example
{
  "subjects": 0,
  "badges": 0,
  "xpGained": 0
}
400

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
401

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
403

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X POST "https://api.agenticdeveloperhub.com/gamification/replay" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "ecosystemId": "string",
  "subjectType": "string",
  "subjectId": "string"
}'
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/gamification/replay", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"ecosystemId\": \"string\",\n  \"subjectType\": \"string\",\n  \"subjectId\": \"string\"\n}",
});
const data = await res.json();