v1

latestOpenAPI 3.1.02026-07-2210284274.4 KB

Agent Compliance

Refresh agent snapshot

Re-probe the agent and update its registry health (online, tools_count, response_time_ms), capability snapshot (inferred type, discovered tools), and compliance verdict (storyboard pass/fail counts). Use after fixing your agent so the registry shows fresh data without waiting for the periodic heartbeat (~1h).

Compliance re-run: when the caller owns the agent or is an AAO admin and the capability probe succeeds, the full storyboard suite can run for several minutes on capability-rich agents with a fresh test session, and agent_storyboard_status is updated. Owner-triggered runs use triggered_by: 'owner_test'; admin-triggered support runs use triggered_by: 'manual'. Badge fan-out reissues verification badges off the new run. If the compliance call fails (timeout, OAuth wall, internal error), the capability/health portion still returns successfully — compliance.ran is false with an error string.

Auth: owner of the agent, AAO admin, or static ADMIN_API_KEY.

Rate limits: 60 seconds per agent URL, 30 requests per user per hour.

post/api/registry/agents/{encodedUrl}/refresh

Path parameters

encodedUrlstring required

URL-encoded agent URL

Example:https%3A%2F%2Fvastlint.org%2Fmcp

URL-encoded agent URL

Response

Snapshot refreshed

onlineboolean required

tools_countinteger nullable required

response_time_msinteger nullable required

inferred_typestring required

Type inferred from discovered tools (sales, creative, signals, governance, etc.) or 'unknown'

type_promotedboolean required

True when registry type was upgraded from unknown to inferred_type

oauth_requiredboolean required

checked_atstring required

errorstring