Get an agent handler

Required scope: agents:admin

GET /api/v1/agents/{agent_name}

cURL

curl --request GET \
  --url 'https://api.nsr.stateset.com/api/v1/agents/{agent_name}' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

{
  "confidence_threshold": 7.5,
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "enabled": true,
  "interval_secs": 1,
  "max_concurrency": 1,
  "name": "Two-Person Tent",
  "require_approval": true,
  "running": true
}

Required scope: agents:admin

Path parameters

agent_name · string · required

Agent name

Response

AgentRuntimeStatus

confidence_threshold · number (float) · required

description · string · required

enabled · boolean · required

interval_secs · integer (int64) · required

max_concurrency · integer · required

name · string · required

require_approval · boolean · required

running · boolean · required

Status codes

Code	Meaning
200	Agent status
401	Unauthorized — missing or invalid credentials
403	Forbidden — the key/token lacks the required scope
404	Agent not found
429	Rate limited — see Retry-After / X-RateLimit-Reset

cURL

curl --request GET \
  --url 'https://api.nsr.stateset.com/api/v1/agents/{agent_name}' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

{
  "confidence_threshold": 7.5,
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "enabled": true,
  "interval_secs": 1,
  "max_concurrency": 1,
  "name": "Two-Person Tent",
  "require_approval": true,
  "running": true
}