Overview
PUT/gamification/realms/{ecosystemId}/levelsgamification

Replace a realm’s level ladder (admin) — must start at 0 and be strictly increasing; POST /replay to backfill

Replace a record in levels by ecosystemId.

Auth: bearerAuth — calls run as the authenticated user.

Parameters
  • ecosystemIdpathstring
Request body

application/json · optional

  • rungsobject[]
Example
{
  "rungs": [
    {
      "name": "string",
      "minPoints": 0
    }
  ]
}
Responses
200

The replaced ladder + replay hint

  • levelsGamificationCatalogLevel[]
  • replayHintstring

    The owner may POST /replay to backfill retroactively

Example
{
  "levels": [
    {
      "name": "string",
      "minPoints": 0,
      "source": "default"
    }
  ],
  "replayHint": "string"
}
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 PUT "https://api.agenticdeveloperhub.com/gamification/realms/{ecosystemId}/levels" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "rungs": [
    {
      "name": "string",
      "minPoints": 0
    }
  ]
}'
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/gamification/realms/{ecosystemId}/levels", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"rungs\": [\n    {\n      \"name\": \"string\",\n      \"minPoints\": 0\n    }\n  ]\n}",
});
const data = await res.json();