Skip to main content
GET
List headless agent runs

Authorizations

Authorization
string
header
required

API key or personal access token (NEX-1042). Send as Authorization: Bearer <token>. Token format:

  • nex_live_… — live API key (server-to-server)
  • nex_test_… — sandbox API key
  • nex_pat_… — personal access token (acts as the issuing user)

Authorization is decided by the key's scopes array, not the owning user's RBAC role. See POST /api/api-keys to mint a key.

Path Parameters

id
integer
required

Agent definition id.

Query Parameters

status
enum<string>

Filter to runs in this status.

Available options:
running,
completed,
pending_approval,
error,
rejected
limit
integer
default:25

Maximum number of runs to return.

Required range: 1 <= x <= 100

Response

Runs for the agent

agentId
integer
runs
object[]