Fetch run history

Container-to-host only. Auth via Bearer run token.

GET/internal/run-history

Authorization

bearerExecToken

AuthorizationBearer <token>

Run token for container-to-host internal routes.

In: header

Query Parameters

limit?integer

Max number of runs to return (1-50, default 10)

Default10

fields?string

Comma-separated fields to include: "checkpoint", "result" (default: "checkpoint")

Default"checkpoint"

curl -X GET "https://your-instance/internal/run-history"

{
  "object": "list",
  "hasMore": false,
  "data": [
    {
      "id": "run_cm9abc123",
      "status": "success",
      "checkpoint": {
        "lastProcessedId": 42
      },
      "date": "2026-01-14T09:00:00Z",
      "duration": 1234
    }
  ]
}

{
  "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"
}

{
  "type": "https://docs.appstrate.dev/errors/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "Resource not found",
  "code": "not_found",
  "request_id": "req_abc123"
}

{
  "type": "https://docs.appstrate.dev/errors/internal-error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected error occurred. Please try again or contact support.",
  "code": "internal_error",
  "request_id": "req_abc123"
}