paperclip_list_run_events
Stream run events for a heartbeat run using a cursor-based afterSeq to resume streaming from a specific sequence number.
Instructions
⚠ Board-only: Stream events for a heartbeat run using an afterSeq cursor (not paginated — cursor-based).
Args:
runId: string — Heartbeat run UUID (example: "run_abc123")
afterSeq: number (optional) — Return events with seq > afterSeq to resume streaming (default: 0)
limit: number (optional) — Max events to return in one call (default 100)
response_format: 'markdown' | 'json' (optional) — Output format (default: markdown)
Returns: Array of run events (no pagination envelope — use afterSeq cursor for continuation). Each event: seq, type, data, createdAt.
Examples:
Use when: streaming execution events for a live or recently completed heartbeat run using the afterSeq cursor
Don't use when: you need raw log bytes — use paperclip_get_run_log with offset/limitBytes instead
Error Handling:
401: authentication failed → check PAPERCLIP_API_KEY
403: permission denied → board-only endpoint, requires board API key
404: run not found → verify runId with paperclip_list_heartbeat_runs
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| runId | Yes | Heartbeat run UUID | |
| afterSeq | No | Return events with sequence number > afterSeq (cursor for streaming, default: 0 / start of run) | |
| limit | Yes | Max events to return (default 100) — note: cursor-based, not paginated | |
| response_format | Yes | Output format: 'markdown' (default, human-readable) or 'json' (structured) | markdown |