List runs

Lists all runs for the organization across all agents, ordered by most recent. Use ?user=me to filter to the current user's runs only.

GET/api/runs

Authorization

better-auth.session_token<token>

Cookie session from Better Auth. Requires X-Org-Id header for org-scoped routes.

In: cookie

Query Parameters

user?string

Filter runs by user. me returns only the current user's runs. Omit for all org runs.

Value in"me"

limit?integer

Maximum number of runs to return

Default20

Rangevalue <= 100

offset?integer

Number of runs to skip

Default0

Header Parameters

X-Org-Id?string

Organization ID. Required for cookie auth. Not needed for API key auth (org resolved from key).

Formatuuid

curl -X GET "https://loading/api/runs"

{
  "runs": [
    {
      "id": "string",
      "packageId": "string",
      "userId": "string",
      "orgId": "string",
      "status": "pending",
      "input": {},
      "result": {},
      "state": {},
      "error": "string",
      "tokensUsed": 0,
      "tokenUsage": {},
      "startedAt": "2019-08-24T14:15:22Z",
      "completedAt": "2019-08-24T14:15:22Z",
      "duration": 0,
      "connectionProfileId": "string",
      "scheduleId": "string",
      "packageVersionId": 0,
      "proxyLabel": "string",
      "modelLabel": "string",
      "cost": 0,
      "endUserId": "string",
      "applicationId": "string"
    }
  ],
  "total": 0
}

{
  "type": "https://docs.appstrate.dev/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Invalid or missing session",
  "code": "unauthorized",
  "requestId": "req_abc123"
}