Skip to main content

Game

The cStar gamification system — player stats, boss battles, leaderboards, achievements, quests, puzzles, social features, cosmetics, seasons, and skill trees. Read endpoints accept any API key; write endpoints require a secret key.

The Gam object

level integer

Player level (resets each season)

xp integer

Current XP within the season

gold integer

Gold balance (earned from tickets and bosses)

skills object

Skill tree allocations (4 skills, max 5 each)

Endpoints

GET Get Player StatsGET Get Player by Member IDGET Get Boss StateGET Is Boss ActivePOST Deal Boss DamagePOST Spawn BossGET Boss Defeat HistoryGET Get Single DefeatGET Get LeaderboardGET Get My RankGET List AchievementsGET Get Single AchievementGET Recent AchievementsGET Today's QuestsGET Quest HistoryGET Get Skill TreePOST Allocate Skill PointPOST Reset SkillsGET Get Current SeasonGET List SeasonsGET Season StatsGET List One-UpsPOST Send One-UpGET One-Ups RemainingGET List High FivesPOST Send High FiveGET Can Send High FiveGET List CosmeticsGET Get Cosmetic PreferencesPATCH Update Cosmetic PreferencesGET Today's PuzzlePOST Complete PuzzleGET Puzzle LeaderboardGET Puzzle StreakGET Team Activity FeedGET Member ActivityGET Game Config
GET /api/v1/teams/{teamId}/game/player

Get Player Stats

Try it

Get a player's game stats including level, XP, gold, skills, streaks, and season info.

Query Parameters

userId string required

User ID

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/player?userId=usr_abc" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Player stats
{
  "success": true,
  "data": {
    "object": "player_stats",
    "memberId": "usr_abc",
    "name": "Jane",
    "avatarUrl": null,
    "season": {
      "id": "2026-Q2",
      "name": "Season 3 — 2026",
      "endsAt": "2026-06-30T23:59:59Z"
    },
    "level": 12,
    "xp": 4850,
    "xpToNextLevel": 1000,
    "xpInCurrentLevel": 850,
    "xpProgress": 0.85,
    "gold": 340,
    "prestigeLevel": 1,
    "prestigeBonus": 0.01,
    "streaks": {
      "current": 7,
      "max": 14
    },
    "stats": {
      "ticketsClosed": 156,
      "bossesDefeated": 8,
      "finalBlows": 2,
      "achievementsUnlocked": 24,
      "questsCompleted": 89
    },
    "skills": {
      "quick_learner": {
        "level": 3,
        "maxLevel": 5,
        "effect": "+15% XP"
      }
    },
    "availableSkillPoints": 2,
    "totalSkillPoints": 8,
    "cosmetics": {
      "avatarFrame": "gold_ring",
      "victoryMessage": "GG!"
    }
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/player/{memberId}

Get Player by Member ID

Get game stats for a specific team member by their membership ID.

Path Parameters

memberId string required

Membership ID of the player

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/player/mem_abc" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Player stats (same shape as GET /player)
{
  "success": true,
  "data": {
    "object": "player_stats"
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/boss

Get Boss State

Try it

Get the current boss battle state including health, phase, abilities, participants, and battle duration.

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/boss" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Boss state
{
  "success": true,
  "data": {
    "object": "boss_state",
    "active": true,
    "boss": {
      "id": "boss_abc",
      "name": "The Backlog Beast",
      "level": 47,
      "difficulty": "hard",
      "maxHealth": 3500,
      "currentHealth": 2180,
      "healthPercent": 0.623,
      "phase": 2,
      "abilities": {
        "shield": null,
        "enrage": {
          "active": true
        },
        "heal": {
          "totalHealed": 175
        }
      },
      "rewards": {
        "xpMultiplier": 2.5,
        "goldMultiplier": 2.5
      },
      "participants": [
        {
          "memberId": "usr_abc",
          "name": "Jane",
          "damage": 780,
          "hits": 12,
          "lastHitAt": "2026-04-06T12:00:00Z"
        }
      ],
      "totalDamage": 1320,
      "spawnedAt": "2026-04-06T10:00:00Z",
      "battleDuration": 7200
    }
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/boss/active

Is Boss Active

Try it

Lightweight check if a boss battle is currently active.

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/boss/active" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Active status
{
  "success": true,
  "data": {
    "object": "boss_active",
    "active": true
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
POST /api/v1/teams/{teamId}/game/boss/damage

Deal Boss Damage

Try it

Deal damage to the current boss. Damage is calculated server-side based on ticket priority, skills, and combo state. Clients cannot specify damage values.

Request Body

userId string required

User dealing damage

userName string

Display name for leaderboard

priority string

Ticket priority (affects damage)

Default: normal

Code Examples

curl -X POST "https://www.cstar.help/api/v1/teams/{teamId}/game/boss/damage" \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"userId":"usr_abc","userName":"Jane","priority":"high"}'

Responses

200 Damage result
{
  "success": true,
  "data": {
    "object": "boss_damage",
    "damage": 127,
    "currentHealth": 2053,
    "healthPercent": 0.587,
    "previousHealthPercent": 0.623,
    "isDefeated": false,
    "isKillingBlow": false,
    "shieldBlocked": false,
    "shieldBroken": false,
    "enrageTriggered": false,
    "activeAbilities": [
      "enrage"
    ]
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
POST /api/v1/teams/{teamId}/game/boss/spawn

Spawn Boss

Try it

Spawn a new boss battle. Fails if a boss is already active.

Request Body

difficulty string

Boss difficulty

Default: medium

Code Examples

curl -X POST "https://www.cstar.help/api/v1/teams/{teamId}/game/boss/spawn" \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"difficulty":"hard"}'

Responses

201 Boss spawned
{
  "success": true,
  "data": {
    "object": "boss_state",
    "active": true,
    "boss": {
      "name": "Queue Crusher",
      "difficulty": "medium",
      "maxHealth": 1500,
      "currentHealth": 1500,
      "healthPercent": 1
    }
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/boss/defeats

Boss Defeat History

Get the history of defeated bosses with participants and rewards.

Query Parameters

page integer

Page number

Default: 1

pageSize integer

Results per page (max 100)

Default: 20

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/boss/defeats?pageSize=5" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Defeat history
{
  "success": true,
  "data": {
    "object": "list",
    "data": [
      {
        "id": "def_abc",
        "bossName": "The Backlog Beast",
        "bossLevel": 47,
        "difficulty": "hard",
        "totalDamage": 3500,
        "finalBlow": {
          "memberId": "usr_abc",
          "name": "Jane",
          "damage": 89
        },
        "defeatedAt": "2026-04-05T18:00:00Z"
      }
    ]
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/boss/defeats/{defeatId}

Get Single Defeat

Get full details for a specific boss defeat.

Path Parameters

defeatId string required

Boss defeat record ID

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/boss/defeats/def_abc" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Defeat details
{
  "success": true,
  "data": {
    "object": "boss_defeat",
    "bossName": "The Backlog Beast",
    "participants": []
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/leaderboard

Get Leaderboard

Try it

Get team leaderboard rankings for a given period.

Query Parameters

period string

Leaderboard period

Default: weekly

limit integer

Max results (max 50)

Default: 20

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/leaderboard?period=weekly" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Leaderboard
{
  "success": true,
  "data": {
    "object": "leaderboard",
    "period": "weekly",
    "entries": [
      {
        "rank": 1,
        "memberId": "usr_abc",
        "name": "Jane",
        "score": 2450,
        "ticketsClosed": 34,
        "bossDamage": 890,
        "currentStreak": 12
      }
    ],
    "totalParticipants": 8,
    "periodStartedAt": "2026-04-01T00:00:00Z",
    "periodEndsAt": "2026-04-08T00:00:00Z"
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/leaderboard/me

Get My Rank

Try it

Get the current user's rank on the leaderboard.

Query Parameters

userId string required

User ID

period string

Period

Default: weekly

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/leaderboard/me?userId=usr_abc" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 User rank
{
  "success": true,
  "data": {
    "object": "leaderboard_entry",
    "rank": 3,
    "totalParticipants": 8,
    "score": 1890
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/achievements

List Achievements

List all achievements with rarity, progress, and summary stats.

Query Parameters

userId string required

User ID

category string

Filter by category (volume, boss, streak, etc.)

unlockedOnly boolean

Only show unlocked achievements

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/achievements?userId=usr_abc&category=boss" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Achievements with progress and summary
{
  "success": true,
  "data": {
    "object": "achievement_list",
    "data": [
      {
        "id": "first_blood",
        "name": "First Blood",
        "description": "Close your first ticket",
        "category": "volume",
        "rarity": "common",
        "xpReward": 25,
        "hidden": false,
        "unlocked": true,
        "progress": {
          "current": 156,
          "target": 1
        }
      }
    ],
    "summary": {
      "total": 100,
      "unlocked": 24,
      "totalXpEarned": 3200,
      "totalGoldEarned": 1600,
      "byCategory": {
        "volume": {
          "total": 11,
          "unlocked": 5
        }
      },
      "byRarity": {
        "common": {
          "total": 30,
          "unlocked": 18
        }
      }
    }
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/achievements/{achievementId}

Get Single Achievement

Get details and progress for a specific achievement.

Path Parameters

achievementId string required

Achievement identifier

Query Parameters

userId string required

User ID

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/achievements/centurion?userId=usr_abc" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Achievement detail
{
  "success": true,
  "data": {
    "id": "centurion",
    "object": "achievement",
    "name": "Centurion",
    "unlocked": true,
    "progress": {
      "current": 156,
      "target": 100
    }
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/achievements/recent

Recent Achievements

Try it

Get recently unlocked achievements across the team.

Query Parameters

limit integer

Max results (max 50)

Default: 10

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/achievements/recent" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Recent unlocks
{
  "success": true,
  "data": {
    "object": "list",
    "data": [
      {
        "id": "centurion",
        "name": "Centurion",
        "rarity": "rare",
        "unlockedBy": {
          "memberId": "usr_abc",
          "name": "Jane"
        },
        "unlockedAt": "2026-04-06T12:00:00Z"
      }
    ]
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/quests/today

Today's Quests

Get today's daily quests with progress. Quests reset at midnight UTC.

Query Parameters

userId string required

User ID

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/quests/today?userId=usr_abc" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Daily quests
{
  "success": true,
  "data": {
    "object": "quest_list",
    "quests": [
      {
        "questId": "close_5_tickets",
        "name": "Ticket Tackler",
        "description": "Close 5 tickets today",
        "difficulty": "easy",
        "progress": 3,
        "target": 5,
        "completed": false,
        "xpReward": 50
      }
    ],
    "completedToday": 1,
    "totalQuests": 4,
    "allComplete": false,
    "completionBonus": null,
    "resetsAt": "2026-04-07T00:00:00Z"
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/quests/history

Quest History

Get past quest completions grouped by date.

Query Parameters

userId string required

User ID

limit integer

Max days (max 90)

Default: 30

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/quests/history?userId=usr_abc" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Quest history
{
  "success": true,
  "data": {
    "object": "quest_history",
    "history": [
      {
        "date": "2026-04-05",
        "quests": [],
        "completedCount": 3
      }
    ]
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/skills

Get Skill Tree

Get the skill tree with current allocations and available points. 4 skills: Quick Learner (+XP), Treasure Hunter (+Gold), Boss Slayer (+Damage), Social Butterfly (+1-Ups).

Query Parameters

userId string required

User ID

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/skills?userId=usr_abc" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Skill tree
{
  "success": true,
  "data": {
    "object": "skill_tree",
    "seasonId": "2026-Q2",
    "skills": [
      {
        "id": "quick_learner",
        "name": "Quick Learner",
        "description": "+5% XP per level",
        "maxLevel": 5,
        "bonusPerLevel": 0.05,
        "currentLevel": 3,
        "isMaxed": false
      }
    ],
    "totalAllocated": 6,
    "availablePoints": 2,
    "playerLevel": 12
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
POST /api/v1/teams/{teamId}/game/skills/allocate

Allocate Skill Point

Try it

Spend an available skill point. Earn 1 point every 5 levels.

Request Body

userId string required

User ID

skillId string required

Skill ID

Code Examples

curl -X POST "https://www.cstar.help/api/v1/teams/{teamId}/game/skills/allocate" \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"userId":"usr_abc","skillId":"quick_learner"}'

Responses

200 Allocation result
{
  "success": true,
  "data": {
    "object": "skill_allocation",
    "skillId": "quick_learner",
    "newLevel": 4,
    "availablePoints": 1
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
POST /api/v1/teams/{teamId}/game/skills/reset

Reset Skills

Try it

Reset all skill allocations, returning points to the available pool.

Request Body

userId string required

User ID

Code Examples

curl -X POST "https://www.cstar.help/api/v1/teams/{teamId}/game/skills/reset" \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"userId":"usr_abc"}'

Responses

200 Skills reset
{
  "success": true,
  "data": {
    "object": "skill_reset",
    "skills": {
      "quick_learner": 0,
      "treasure_hunter": 0,
      "boss_slayer": 0,
      "social_butterfly": 0
    },
    "availablePoints": 8
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/seasons/current

Get Current Season

Get the current active season with badge thresholds and days remaining.

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/seasons/current" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Current season
{
  "success": true,
  "data": {
    "object": "season",
    "id": "2026-Q2",
    "name": "Season 3 — 2026",
    "isActive": true,
    "startsAt": "2026-04-01T00:00:00Z",
    "endsAt": "2026-06-30T23:59:59Z",
    "daysRemaining": 85,
    "badges": [
      {
        "level": 10,
        "name": "Participant",
        "color": "#8B4513"
      },
      {
        "level": 25,
        "name": "Bronze",
        "color": "#CD7F32"
      },
      {
        "level": 50,
        "name": "Silver",
        "color": "#C0C0C0"
      },
      {
        "level": 75,
        "name": "Gold",
        "color": "#FFD700"
      },
      {
        "level": 100,
        "name": "Diamond",
        "color": "#B9F2FF"
      }
    ],
    "teamParticipants": 8
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/seasons

List Seasons

Try it

Get all seasons (current and past).

Query Parameters

limit integer

Max results (max 20)

Default: 10

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/seasons" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Season list
{
  "success": true,
  "data": [
    {
      "object": "season",
      "id": "2026-Q1",
      "isActive": false,
      "daysRemaining": 0
    }
  ]
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/seasons/{seasonId}/stats

Season Stats

Get a user's stats for a specific season (current or past).

Path Parameters

seasonId string required

Season identifier (e.g. 2026-Q1)

Query Parameters

userId string required

User ID

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/seasons/2026-Q1/stats?userId=usr_abc" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Season stats
{
  "success": true,
  "data": {
    "object": "season_stats",
    "seasonId": "2026-Q1",
    "level": 18,
    "xp": 18000,
    "ticketsClosed": 342
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/one-ups

List One-Ups

Try it

Get recent one-ups on the team.

Query Parameters

limit integer

Max results (max 50)

Default: 20

userId string

Filter by sender or recipient

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/one-ups" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 One-ups list
{
  "success": true,
  "data": {
    "object": "list",
    "data": [
      {
        "id": "1up_abc",
        "object": "one_up",
        "sender": {
          "id": "usr_abc",
          "name": "Jane"
        },
        "recipient": {
          "id": "usr_bob",
          "name": "Bob"
        },
        "message": "Great work!",
        "goldAmount": 0,
        "wasFree": true,
        "createdAt": "2026-04-06T12:00:00Z"
      }
    ]
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
POST /api/v1/teams/{teamId}/game/one-ups

Send One-Up

Try it

Send a one-up to a teammate. 3 free per day (+ social_butterfly skill bonus). Gold one-ups deduct from sender balance. Max 140 char message, max 100 gold.

Request Body

senderId string required

Sender user ID

senderName string

Sender display name

recipientId string required

Recipient user ID

recipientName string

Recipient display name

message string

Kudos message (max 140 chars)

goldAmount integer

Gold to gift (0-100)

Default: 0

Code Examples

curl -X POST "https://www.cstar.help/api/v1/teams/{teamId}/game/one-ups" \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"senderId":"usr_abc","recipientId":"usr_bob","message":"Great work!"}'

Responses

201 One-up sent
{
  "success": true,
  "data": {
    "object": "one_up",
    "id": "1up_abc",
    "wasFree": true,
    "freeRemaining": 2,
    "sender": {
      "id": "usr_abc",
      "name": "Jane"
    },
    "recipient": {
      "id": "usr_bob",
      "name": "Bob"
    },
    "message": "Great work!",
    "goldAmount": 0,
    "recipientXpAwarded": 10,
    "recipientGoldAwarded": 5
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/one-ups/remaining

One-Ups Remaining

Check how many free one-ups remain today.

Query Parameters

userId string required

User ID

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/one-ups/remaining?userId=usr_abc" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Remaining count
{
  "success": true,
  "data": {
    "object": "one_up_remaining",
    "freeOneUpsRemaining": 2,
    "maxFreeOneUps": 4,
    "sentToday": 1
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/high-fives

List High Fives

Try it

Get recent high fives sent to or from this team.

Query Parameters

limit integer

Max results (max 50)

Default: 20

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/high-fives" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 High fives list
{
  "success": true,
  "data": {
    "object": "list",
    "data": [
      {
        "id": "hf_abc",
        "object": "high_five",
        "senderTeam": {
          "id": "team_abc",
          "name": "Support Heroes"
        },
        "recipientTeam": {
          "id": "team_xyz",
          "name": "Bug Busters"
        },
        "message": "Crushing it!",
        "createdAt": "2026-04-06T12:00:00Z"
      }
    ]
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
POST /api/v1/teams/{teamId}/game/high-fives

Send High Five

Try it

Send a high five to another team. Limited to 1 per team per day. Max 80 char message.

Request Body

recipientTeamId string required

Target team ID

recipientTeamName string

Target team name

senderUserId string

Sender user ID

senderUserName string

Sender name

senderTeamName string

Your team name

message string

Message (max 80 chars)

Code Examples

curl -X POST "https://www.cstar.help/api/v1/teams/{teamId}/game/high-fives" \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"recipientTeamId":"team_xyz","message":"Amazing work!"}'

Responses

201 High five sent
{
  "success": true,
  "data": {
    "id": "hf_abc",
    "object": "high_five",
    "senderTeam": {
      "id": "team_abc",
      "name": "Support Heroes"
    },
    "recipientTeam": {
      "id": "team_xyz",
      "name": "Bug Busters"
    }
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/high-fives/can-send/{recipientTeamId}

Can Send High Five

Check if you can send a high five to a specific team today.

Path Parameters

recipientTeamId string required

Team ID of the recipient

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/high-fives/can-send/team_xyz" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Eligibility
{
  "success": true,
  "data": {
    "canSend": true,
    "highFivesRemaining": 1
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/cosmetics

List Cosmetics

Try it

Get all cosmetic items with unlock status.

Query Parameters

userId string required

User ID

type string

Filter by type

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/cosmetics?userId=usr_abc" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Cosmetics list
{
  "success": true,
  "data": [
    {
      "id": "gold_ring",
      "type": "frame",
      "name": "Gold Ring",
      "unlocked": true,
      "equipped": true
    }
  ]
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/cosmetics/preferences

Get Cosmetic Preferences

Get the user's currently equipped cosmetics.

Query Parameters

userId string required

User ID

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/cosmetics/preferences?userId=usr_abc" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Preferences
{
  "success": true,
  "data": {
    "object": "cosmetic_preferences",
    "avatarFrame": "gold_ring",
    "victoryMessage": "GG!"
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
PATCH /api/v1/teams/{teamId}/game/cosmetics/preferences

Update Cosmetic Preferences

Equip a cosmetic. Can only equip unlocked items. Victory message max 200 chars.

Request Body

userId string required

User ID

avatarFrame string

Frame ID to equip

victoryMessage string

Victory message (max 200 chars)

Code Examples

curl -X PATCH "https://www.cstar.help/api/v1/teams/{teamId}/game/cosmetics/preferences" \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"userId":"usr_abc","avatarFrame":"fire_frame"}'

Responses

200 Updated preferences
{
  "success": true,
  "data": {
    "object": "cosmetic_preferences",
    "avatarFrame": "fire_frame",
    "victoryMessage": "GG!"
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/puzzles/today

Today's Puzzle

Try it

Get today's daily warm-up puzzle.

Query Parameters

userId string

Include completion status if provided

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/puzzles/today" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Daily puzzle
{
  "success": true,
  "data": {
    "object": "daily_puzzle",
    "available": true,
    "puzzle": {
      "id": "puz_abc",
      "date": "2026-04-06",
      "type": "categories",
      "data": {}
    },
    "completion": null
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
POST /api/v1/teams/{teamId}/game/puzzles/complete

Complete Puzzle

Record a puzzle completion. Awards XP based on time and mistakes.

Request Body

userId string required

User ID

puzzleId string required

Puzzle ID

timeSeconds integer required

Time to complete

mistakes integer required

Number of mistakes (0-4)

isWon boolean required

Whether the puzzle was solved

Code Examples

curl -X POST "https://www.cstar.help/api/v1/teams/{teamId}/game/puzzles/complete" \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"userId":"usr_abc","puzzleId":"puz_abc","timeSeconds":42,"mistakes":1,"isWon":true}'

Responses

201 Completion recorded
{
  "success": true,
  "data": {
    "object": "puzzle_completion",
    "score": 850,
    "xpEarned": 25,
    "streak": {
      "current": 6,
      "longest": 12,
      "totalCompleted": 45
    }
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/puzzles/leaderboard

Puzzle Leaderboard

Try it

Get puzzle leaderboard — by scores (for a specific puzzle) or by streaks.

Query Parameters

type string

Leaderboard type

Default: streaks

puzzleId string

Required when type=scores

limit integer

Max results (max 50)

Default: 10

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/puzzles/leaderboard?type=streaks" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Puzzle leaderboard
{
  "success": true,
  "data": {
    "object": "puzzle_leaderboard",
    "type": "streaks",
    "entries": [
      {
        "rank": 1,
        "userId": "usr_abc",
        "currentStreak": 12,
        "longestStreak": 20
      }
    ]
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/puzzles/streak

Puzzle Streak

Try it

Get a user's puzzle streak stats.

Query Parameters

userId string required

User ID

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/puzzles/streak?userId=usr_abc" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Streak stats
{
  "success": true,
  "data": {
    "object": "puzzle_streak",
    "currentStreak": 5,
    "longestStreak": 12,
    "totalCompleted": 45
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/activity

Team Activity Feed

Try it

Get the team-wide game activity feed. Supports cursor-based pagination.

Query Parameters

limit integer

Max results (max 100)

Default: 50

before string

Cursor — activity ID to paginate from

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/activity?limit=20" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Activity feed
{
  "success": true,
  "data": {
    "object": "list",
    "data": [
      {
        "id": "act_abc",
        "action": "boss_defeated",
        "actor": {
          "id": "usr_abc",
          "name": "Jane"
        },
        "icon": "skull",
        "metadata": {
          "bossName": "The Backlog Beast"
        },
        "createdAt": "2026-04-06T12:00:00Z"
      }
    ],
    "cursor": "act_abc"
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/activity/member/{memberId}

Member Activity

Get activity feed for a specific team member.

Path Parameters

memberId string required

Membership ID of the team member

Query Parameters

limit integer

Max results (max 100)

Default: 20

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/activity/member/usr_abc" \
  -H "Authorization: Bearer sk_live_your_key"

Responses

200 Member activity
{
  "success": true,
  "data": {
    "object": "list",
    "data": []
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
GET /api/v1/teams/{teamId}/game/config

Game Config

Try it

Get game balance constants (XP per level, boss difficulties, reward tables, etc). Read-only, no database calls. Any API key can access.

Code Examples

curl -X GET "https://www.cstar.help/api/v1/teams/{teamId}/game/config" \
  -H "Authorization: Bearer pk_live_your_key"

Responses

200 Game config
{
  "success": true,
  "data": {
    "object": "game_config",
    "rewards": {
      "ticketRewards": {
        "low": {
          "xp": 10,
          "gold": 5
        },
        "normal": {
          "xp": 25,
          "gold": 10
        },
        "high": {
          "xp": 50,
          "gold": 20
        },
        "urgent": {
          "xp": 75,
          "gold": 30
        }
      }
    },
    "leveling": {
      "xpPerLevel": 1000,
      "prestigeThreshold": 25,
      "prestigeBonus": 0.01
    },
    "social": {
      "freeOneUpsPerDay": 3,
      "maxGoldGift": 100,
      "highFivesPerTeamPerDay": 1
    },
    "scoring": {
      "phi": 1.618,
      "priorityMultipliers": {
        "urgent": 4.236,
        "high": 2.618,
        "normal": 1.618,
        "low": 1
      }
    }
  }
}
401 Authentication failed — missing or invalid API key
{
  "success": false,
  "error": {
    "type": "authentication_error",
    "code": "authentication_required",
    "message": "Invalid or expired API key",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
403 Insufficient permissions — wrong key type or team access
{
  "success": false,
  "error": {
    "type": "authorization_error",
    "code": "insufficient_permissions",
    "message": "Secret key required for this endpoint",
    "doc_url": "https://www.cstar.help/developers/api-reference#authentication",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}
429 Rate limit exceeded
{
  "success": false,
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "doc_url": "https://www.cstar.help/developers/api-reference#rate-limiting",
    "request_id": "req_abc123"
  },
  "meta": {
    "timestamp": "2025-12-10T14:30:00Z"
  }
}