List headless agent runs
Agents
List headless agent runs
List the credential-user’s runs for this agent, newest first. Optionally
filter by status and cap the page with limit. Requires the
agents:run scope; only runs owned by the credential’s user are returned.
GET
List headless agent runs
Authorizations
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 keynex_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
Agent definition id.
Query Parameters
Filter to runs in this status.
Available options:
running, completed, pending_approval, error, rejected Maximum number of runs to return.
Required range:
1 <= x <= 100
