API Reference

Queue API

Endpoints for managing the human-in-the-loop approval queue. Use these to list pending requests and submit human decisions.

List Pending Requests

GET/api/v1/queue
// Response
{
  "requests": [
    {
      "id": "req_67890fghij",
      "agent_id": "agent-123",
      "action": "delete_user",
      "resource": "user:456",
      "confidence": 0.85,
      "status": "pending",
      "created_at": "2023-10-27T10:00:00Z"
    }
  ]
}

Approve a Request

POST/api/v1/queue/:id/approve
// Request Body
{
  "reviewer_id": "user_789",
  "comment": "Approved per support ticket #9921" // Optional
}

// Response (200 OK)
{
  "status": "success",
  "message": "Request approved"
}

Deny a Request

POST/api/v1/queue/:id/deny
// Request Body
{
  "reviewer_id": "user_789",
  "comment": "Agent misunderstood the user's intent." // Optional
}

// Response (200 OK)
{
  "status": "success",
  "message": "Request denied"
}