Skip to main content
GET
/
api
/
agent-runs
/
{run_id}
/
hitl-status
Get HITL status for a run
curl --request GET \
  --url https://api.getgranite.ai/api/agent-runs/{run_id}/hitl-status
{
  "run_id": "<string>",
  "has_active_manager": true,
  "is_paused": true,
  "is_cancelled": true,
  "pending_requests": [
    {
      "request_id": "<string>",
      "request_type": "<string>",
      "data": {},
      "created_at": "<string>"
    }
  ],
  "stats": {
    "run_id": "<string>",
    "total_requests": 123,
    "pending": 123,
    "answered": 123,
    "expired": 123,
    "cancelled": 123
  },
  "manager_state": {
    "questions": [
      "<string>"
    ],
    "approvals": [
      "<string>"
    ],
    "is_paused": true,
    "pause_reason": "<string>"
  }
}

Path Parameters

run_id
string
required

Response

Successful Response

HITL status for a run.

run_id
string
required

Run ID

has_active_manager
boolean
required

Whether an active HITL manager exists

is_paused
boolean
required

Whether pipeline is paused

is_cancelled
boolean
required

Whether pipeline is cancelled

pending_requests
HITLPendingRequest · object[]
required

Pending HITL requests

stats
HITLStats · object
required

HITL statistics

manager_state
HITLManagerState · object

Manager state if active