A research run's progress events
The run's progress log in ascending seq order (the durable source of truth for what the agent did). Poll with sinceSeq set to the last seq you have seen: only newer events come back. A full page sets nextSinceSeq to its last seq (pass it as the next sinceSeq); otherwise it is null and you are caught up. status is the run's current status so a poller can stop when it is completed, failed or cancelled. Event types: run.status_changed, plan.created, tool.started, tool.finished, progress, partial_result, artifact, run.completed, run.failed, run.cancelled; payload depends on the type. Rate limit: 30 requests per minute, 1000 per day.
Errors:
- 404 RESEARCH_RUN_NOT_FOUND — No research run with that id belongs to the token owner.
- 422 VALIDATION_FAILED — runId is not a 24-character hex id, sinceSeq is not an integer of 0 or more, or limit is outside 1-500.
- 429 RATE_LIMITED — Per-user quota for this endpoint family exceeded (30 per minute, 1000 per day); retry after the Retry-After / RateLimit-Reset seconds.
Requires one of the following token scopes: research.
Request
- Base URL: https://api.tryfuse.ai/api/v1
- URL: https://api.tryfuse.ai/api/v1/business/research/runs/{runId}/events
- Auth: HTTP basic
Path parameters
The research run id (24-character hex), as returned in run.runId by POST /business/research/runs.
Query parameters
Return only events whose seq is strictly greater than this value; pass the last seq you received (or nextSinceSeq) to poll incrementally, omit it for the first page.
Maximum number of events per page, 1 to 500 (default 100); when a page comes back full, nextSinceSeq carries the last seq to continue from.
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.