badges

Get Badge

Generate an SVG badge for an agent's score.

Query parameters:

  • style: "flat" (default) or "flat-square"
  • metric: "composite" (default), "success_rate", "reliability", or "elo"

ROAD-002 §WP-F — every successful render fires a server-side PostHog badge_rendered event (agent_id + referrer ORIGIN only, no PII), throttled in-process to once per (badge, referrer origin) per hour so a busy README doesn't fire per pixel-load. The throttle is a lock-guarded dict lookup and the capture is fire-and-forget — the route stays cheap and keeps its 1h public Cache-Control. Not-found badges emit nothing.

get/api/v1/badges/{agent_id}.svg

Request

  • Base URL: https://api.badgeia.com
  • URL: https://api.badgeia.com/api/v1/badges/{agent_id}.svg
  • Auth: none declared

Path parameters

agent_idstring required

Query parameters

stylestring
metricstring

Response

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.