Overview
GET/gamification/realms/{ecosystemId}/configgamification

Read a realm’s gamification config (admin) — defaults when unset

Fetch a record from config by ecosystemId.

Auth: bearerAuth — calls run as the authenticated user.

Parameters
  • ecosystemIdpathstring
Responses
200

Realm config

  • ecosystemIdstring
  • enabledboolean

    false leaves telemetry flowing but suppresses awards/UI

  • skin"rpg" | "plain"
  • surfacesobject

    Per-surface toggles; a surface is ON unless set false

  • seasonsGamificationSeasons

    Season board window config; null ⇒ seasons off

  • timezonestring

    IANA timezone for the realm's day/streak boundary (Night Owl); defaults to 'UTC'

Example
{
  "ecosystemId": "string",
  "enabled": true,
  "skin": "rpg",
  "surfaces": {},
  "seasons": {
    "anchor": "string",
    "lengthDays": 0
  },
  "timezone": "string"
}
401

Error

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

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X GET "https://api.agenticdeveloperhub.com/gamification/realms/{ecosystemId}/config" \
  -H "Authorization: Bearer YOUR_TOKEN"
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/gamification/realms/{ecosystemId}/config", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  },
});
const data = await res.json();