Observability

The breakdown behind one agent's trust score

The topology carries a single 0-100 trust number per agent. This is what it is made of: each weighted component (null when this deployment has no source for it — not measured, not zero), a 24-hour history for a sparkline, and the agent's last audit actions. Actions and resource types only; audit metadata is where secret paths live and it is not returned.

Scores are shadow until the engine is promoted out of recommend-only mode; an agent the engine has not yet reached returns score: null and shadow: true.

Human users only. An agent id outside the caller's org is a 404, not a 403, so the response does not confirm the id exists.

get/v1/otel/agents/{agent_id}/trust

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/otel/agents/{agent_id}/trust
  • Auth: HTTP bearer

Path parameters

agent_idstring uuid required

Response

Current score, components, history, recent actions

agent_idstring uuid required
scoreinteger nullable
shadowboolean required

True while the engine is recommend-only or the agent is unscored.

updated_atstring date-time nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.