Skip to content
Anlyon
Esc
↑↓navigate↵open⌘Jpreview

List runs

Newest first. Search run ID, name, or application; filter by status, agent, user, and time range.

GET/api/v2/runs
Authorization
AuthorizationBearer token (Anlyon API key) · headerrequired

Workspace API key sent as Authorization: Bearer <key>.

or
better-auth.session_tokenAPI key · cookierequired

Browser session used by dashboard-only operations.

Query parameters
searchstring

Case-insensitive substring search across run ID, name, and application.

min length 1 · max length 200
statusstring
Allowed:runningsucceededfailedcancelled
agentIdstring
userIdstring
environmentIdstring<uuid>

Filter to one environment. API keys are already environment-scoped; this is for the session-authed dashboard viewing across environments.

startedAfterstring<date-time>
startedBeforestring<date-time>
limitinteger
min 1 · max 100 · default: 20
offsetinteger
min 0 · default: 0
Header parameters
X-Request-Idstring

Optional caller correlation ID. Unsafe or oversized values are replaced.

max length 128
Responses
200

Runs, newest first.

successbooleanrequired
Allowed:true
dataRun[]required
Show properties
Array of Run
idstringrequired

Public run id (run_xxx).

agentIdstring | null
agentVersionstring | null
environmentIdstring<uuid>required
namestring | nullrequired
statusstringrequired
Allowed:runningsucceededfailedcancelled
userIdstring | null
applicationstring | null
inputany | null
outputany | null
errorobject | null
tokensinteger | null
costnumber | null
tagsstring[] | null
metadataobject | null
startedAtstring<date-time>required
endedAtstring<date-time> | null
durationMsinteger | null
paginationOffsetPagination
Show properties
totalintegerrequired
min 0
pageintegerrequired
min 1
limitintegerrequired
min 1
totalPagesintegerrequired
min 0
hasMorebooleanrequired
400

Bad Request - Invalid input data

successbooleanrequired
requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired
Show properties
codestring
messagestring
detailsobject
401

Unauthorized - Invalid or missing API key

successbooleanrequired
requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired
Show properties
codestring
messagestring
detailsobject
403

Authenticated credential lacks the required scope or workspace access.

successbooleanrequired
requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired
Show properties
codestring
messagestring
detailsobject
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://api.anlyon.com/api/v2/runs' \
  -H 'Authorization: Bearer YOUR_TOKEN'
Response
{
  "success": true,
  "data": [
    {
      "id": "string",
      "agentId": "string",
      "agentVersion": "string",
      "environmentId": "19f5cc2e-7657-437a-9268-83cd3d563563",
      "name": "string",
      "status": "running",
      "userId": "string",
      "application": "string",
      "input": null,
      "output": null,
      "error": {},
      "tokens": 0,
      "cost": 0,
      "tags": [
        "string"
      ],
      "metadata": {},
      "startedAt": "2019-08-24T14:15:22Z",
      "endedAt": "2019-08-24T14:15:22Z",
      "durationMs": 0
    }
  ],
  "pagination": {
    "total": 0,
    "page": 1,
    "limit": 1,
    "totalPages": 0,
    "hasMore": true
  }
}