List agents
GET /api/v1/agents
| Parameter | Type | Description |
|---|---|---|
status | string | Filter by status: APPROVED, DISCOVERED, PENDING_REVIEW |
risk_level | string | Filter by risk: CRITICAL, HIGH, MEDIUM, LOW |
framework | string | Filter by framework: LANGGRAPH, N8N, etc. |
department | string | Filter by department name |
no_owner | bool | Show only agents with no owner |
search | string | Search by name |
sort_by | string | risk_score (default), name, created_at |
sort_dir | string | desc (default), asc |
limit | int | Max results, default 100, max 500 |
curl https://app.getmuster.io/api/v1/agents?risk_level=CRITICAL \
-H "Authorization: Bearer {token}"
[
{
"agent_id": "uuid",
"name": "invoice-processor-v2",
"framework": "LANGGRAPH",
"risk_level": "HIGH",
"risk_score": 55,
"status": "APPROVED",
"owner_email": "finance@acme.com",
"department": "Finance",
"contains_pii": true,
"external_llm_calls": true,
"writes_to_systems": true,
"hitl_required": true,
"primary_model": "gpt-4o",
"probe_reachable": true,
"probe_tls_valid": true,
"created_at": "2026-02-07T06:00:00Z",
"updated_at": "2026-03-24T06:00:00Z"
}
]
Get agent
GET /api/v1/agents/{agent_id}
Create agent
POST /api/v1/agents
{
"name": "fraud-detector-v3",
"framework": "AUTOGEN",
"owner_email": "risk@acme.com",
"department": "Risk",
"contains_pii": true,
"writes_to_systems": true,
"hitl_required": false,
"primary_model": "gpt-4o",
"model_provider": "openai"
}
Update agent
PATCH /api/v1/agents/{agent_id}
Registry stats
GET /api/v1/registry/stats
{
"total": 23,
"approved": 23,
"critical": 1,
"high": 8,
"medium": 9,
"low": 5,
"no_owner": 5,
"has_discrepancies": 2
}
Beacon auto-registration
POST /api/v1/agents/beacon
beacon.register(). No auth required.
{
"agent_id": "invoice-processor-v2",
"version": "2.1.0",
"framework": "LANGGRAPH",
"endpoint_url": "https://agent.internal.acme.com"
}