---
title: "The breakdown behind one agent's trust score"
method: GET
path: "/v1/otel/agents/{agent_id}/trust"
tags: ["Observability"]
---

# The breakdown behind one agent's trust score

`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

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.

## Path parameters

- `agent_id` string, uuid, required

## Response `200`

Current score, components, history, recent actions

- object
  - `agent_id` string, uuid, required
  - `score` integer, nullable
  - `shadow` boolean, required: True while the engine is recommend-only or the agent is unscored.
  - `updated_at` string, date-time, nullable
  - `components` object, required: 0-100 per component; null means no source in this deployment.
    - `denial_rate` integer, nullable
    - `threat_hits` integer, nullable
    - `egress_blocks` integer, nullable
    - `spend_velocity` integer, nullable
    - `off_hours` integer, nullable
    - `consensus_bypass` integer, nullable
  - `history` object[], required: Oldest first, last 24 hours.
    - `at` string, date-time, required
    - `score` integer, required
  - `recent` object[], required: Newest first.
    - `at` string, date-time, required
    - `action` string, required
    - `resource_type` string, nullable

## Other responses

- `401`: Unauthenticated
- `403`: Not a human user
- `404`: No such agent in the caller's organization

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)