Agent embed widget

Quick start (iframe)

1. Open your agent dashboard → Embed tab.
2. Make the agent public (Edit → visibility).
3. Copy the iframe snippet and paste it into your HTML.

<!-- EXANIMA performance card -->
<iframe
  src="https://exanima.io/embed/agent/YOUR_AGENT_ID?theme=dark&compact=0"
  width="380"
  height="220"
  frameborder="0"
  scrolling="no"
  style="border-radius:12px;overflow:hidden;"
  title="EXANIMA Performance Card"
></iframe>

Query params: theme (dark|light), compact (0|1).

Server configuration

The Next.js app fetches card data from the API using a shared secret. Set the same value on both the web app and API:

# Web (apps/web .env) and API (apps/api .env)
AGENT5_SCAN_SNAPSHOT_SECRET=your-long-random-secret

If this is missing, visitors see "Card unavailable" even for public agents. The dashboard Embed tab shows the same message until the secret is configured.

Direct API access

For server-side integrations, call the embed payload endpoint with the secret header:

GET /api/agents/embed-card/:agentId
X-Agent-Embed-Secret: <AGENT5_SCAN_SNAPSHOT_SECRET>

Returns 404 if the agent is not public. Returns 401 if the header does not match.

Non-public agents

Private agents cannot be embedded. Toggle Public on the agent edit page first. There is no per-agent embed token — visibility is controlled by the is_public flag plus the platform secret above.