Badge Embeds

Display a live trust badge for any agent on your website, README, or documentation. Badges are rendered as SVG images that update automatically.

---

Badge URL

https://veriswarm.ai/v1/badge/{agent-slug}.svg

Replace {agent-slug} with the agent's slug (the URL-safe identifier shown on the agent's profile page).

---

Styles

Two badge styles are available, controlled by the style query parameter:

Compact (default)

A single-line pill showing the tier label, composite trust score, and verification status.

https://veriswarm.ai/v1/badge/my-agent.svg?style=compact

Renders approximately 220px wide and 28px tall.

Card

A detailed card showing all four dimension scores with bar charts.

https://veriswarm.ai/v1/badge/my-agent.svg?style=card

Renders 256px wide and 160px tall. Shows Identity, Risk, Reliability, and Autonomy scores with color-coded bars.

---

Themes

Control the color scheme with the theme query parameter:

Parameter	Background	Best For
theme=dark (default)	Dark charcoal (#110f0d / #191613)	Dark backgrounds, GitHub dark mode
theme=light	Warm cream (#f5f0e8)	Light backgrounds, documentation sites

Examples:

https://veriswarm.ai/v1/badge/my-agent.svg?style=compact&theme=dark
https://veriswarm.ai/v1/badge/my-agent.svg?style=card&theme=light

---

Embedding

HTML

<!-- Compact badge -->
<a href="https://veriswarm.ai/agents/my-agent">
  <img
    src="https://veriswarm.ai/v1/badge/my-agent.svg?style=compact&theme=dark"
    alt="VeriSwarm Trust Badge"
  />
</a>

<!-- Detailed card -->
<a href="https://veriswarm.ai/agents/my-agent">
  <img
    src="https://veriswarm.ai/v1/badge/my-agent.svg?style=card&theme=dark"
    alt="VeriSwarm Trust Report"
  />
</a>

Markdown (GitHub READMEs)

[![VeriSwarm Trust Badge](https://veriswarm.ai/v1/badge/my-agent.svg?style=compact&theme=dark)](https://veriswarm.ai/agents/my-agent)

For GitHub's dark/light mode, use the theme=dark variant -- it works well on both modes due to the distinct background color. If you need to support both themes explicitly, use GitHub's #gh-dark-mode-only and #gh-light-mode-only fragments:

[![Trust Badge](https://veriswarm.ai/v1/badge/my-agent.svg?style=compact&theme=dark#gh-dark-mode-only)](https://veriswarm.ai/agents/my-agent)
[![Trust Badge](https://veriswarm.ai/v1/badge/my-agent.svg?style=compact&theme=light#gh-light-mode-only)](https://veriswarm.ai/agents/my-agent)

---

Caching

Badges are served with a Cache-Control: public, max-age=3600 header (1 hour). This means:

• Badge images are cached by browsers and CDNs for up to 1 hour.
• Score changes will be reflected within 1 hour of the next score computation.
• You do not need to cache-bust or add version parameters.

If you need to force a fresh badge (e.g., for testing), append a random query parameter:

https://veriswarm.ai/v1/badge/my-agent.svg?style=compact&_t=1711234567

---

CORS

Badge endpoints serve SVG with appropriate CORS headers, so cross-origin embedding works from any domain. No special configuration is needed on your side.

---

Unscored Agents

If the agent has not been scored yet (no events ingested), the badge displays a neutral "Not Yet Scored" label instead of scores. This avoids showing misleading zero-score badges for newly registered agents.

---

Linking to Agent Profiles

Wrap the badge image in a link to the agent's public profile page:

https://veriswarm.ai/agents/{agent-slug}

This gives viewers a way to inspect the full trust report, score history, and verification status.

---

Custom Domains

If you have configured a custom domain for your workspace, badges can also be served from your domain once DNS verification is complete. The badge URL format remains the same with your domain substituted.