List runs for a schedule

List recent runs triggered by a specific schedule. Takes schedules:read AND a run read permission: the rows are runs, so runs:read lists the ones the caller launched — including the runs of the caller's own schedules — and runs:read-all the whole space. A credential holding schedules:read alone is rejected with 403.

GET/api/schedules/{id}/runs

Authorization

better-auth.session_token<token>

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

In: cookie

Path Parameters

id*string

Query Parameters

limit?integer

Default20

Range1 <= value <= 100

offset?integer

Number of items to skip before the first returned item.

Default0

Range0 <= value

Header Parameters

X-Org-Id?string

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

Formatuuid

X-Space-Id?string

Space ID. Required for space-scoped routes (agents, runs, schedules, and space-scoped module routes). Not needed for API key auth (space resolved from key).

curl -X GET "https://your-instance/api/schedules/string/runs"

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "packageId": "string",
      "userId": "string",
      "orgId": "string",
      "status": "pending",
      "input": {},
      "result": {
        "output": null
      },
      "artifacts": {
        "status": "complete",
        "published": 0,
        "failed": [
          {
            "name": "string",
            "code": "string"
          }
        ]
      },
      "checkpoint": {},
      "error": "string",
      "token_usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "cache_creation_input_tokens": 0,
        "cache_read_input_tokens": 0
      },
      "started_at": "2019-08-24T14:15:22Z",
      "completed_at": "2019-08-24T14:15:22Z",
      "duration": 0,
      "scheduleId": "string",
      "version_label": "string",
      "version_ref": "string",
      "proxy_label": "string",
      "model_label": "string",
      "model_source": "system",
      "cost": 0,
      "cost_pricing_status": "priced",
      "endUserId": "string",
      "apiKeyId": "string",
      "spaceId": "string",
      "metadata": {},
      "generation": {
        "temperature": 0,
        "reasoning_level": "off"
      },
      "generation_override": {
        "temperature": 0,
        "reasoning_level": "off"
      },
      "user_name": "string",
      "end_user_name": "string",
      "api_key_name": "string",
      "schedule_name": "string",
      "runner_name": "string",
      "runner_kind": "string",
      "agent_scope": "string",
      "agent_name": "string",
      "package_ephemeral": true,
      "file_counts": {
        "input": 0,
        "output": 0
      },
      "inline_manifest": {},
      "inline_prompt": "string",
      "unread": true,
      "runNumber": 0,
      "runOrigin": "platform",
      "contextSnapshot": {},
      "modelCredentialId": "string",
      "connection_overrides": {
        "property1": [
          "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ],
        "property2": [
          "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        ]
      },
      "dependency_overrides": {
        "property1": "string",
        "property2": "string"
      },
      "connections_used": [
        {
          "integration_package_id": "string",
          "label": "string",
          "account_id": "string",
          "source": "admin_pin"
        }
      ]
    }
  ],
  "total": 0,
  "hasMore": true
}

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

{
  "type": "https://docs.appstrate.dev/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "Insufficient permissions",
  "code": "forbidden",
  "request_id": "req_abc123"
}