Admin API Reference

Base URL: https://admin.avon.example.com/api/v1

Authentication: Bearer token (JWT) in the Authorization header.

Agents

Example — List online agents:

curl -H "Authorization: Bearer $TOKEN" 
  "https://admin.avon.example.com/api/v1/agents?status=online"

Enrollment Tokens

Example — Create an enrollment token:

curl -X POST -H "Authorization: Bearer $TOKEN" 
  -H "Content-Type: application/json" 
  -d '{
    "name": "batch-engineering",
    "groups": ["engineering"],
    "expires_in": "24h",
    "max_uses": 50
  }' 
  "https://admin.avon.example.com/api/v1/enrollment-tokens"

Policies

Example — Dry-run a policy check:

curl -X POST -H "Authorization: Bearer $TOKEN" 
  -H "Content-Type: application/json" 
  -d '{
    "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "resource": {
      "network": "10.100.5.0/24",
      "port": 443,
      "protocol": "tcp"
    }
  }' 
  "https://admin.avon.example.com/api/v1/policies/evaluate"

Sessions

Groups

Health