Stream a Find More operation

GET/api/v2/websets/{webset_id}/find-more/stream

Streams state, strategy, and item changes for one specific Find More job. Requires websets:read.

Request

cURL
curl -N "https://revor.ai/api/v2/websets/WEBSET_ID/find-more/stream?job_id=JOB_ID&cursor=289&items_revision=18&match=qualified" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME" \
  -H "Accept: text/event-stream"

Parameter	Required	Description
`job_id`	Yes	`item.id` returned by Find More.
`cursor`	Paired with revision	`stream_cursor` captured before starting Find More.
`items_revision`	Paired with cursor	`items_revision` captured before starting Find More.
`match`	No	Defaults to `qualified`.

Bind the stream to the current job_id. The server waits until it observes that job's new discovery run and will not treat the previous run's stale completed state as completion.

Events

This endpoint includes the Items SSE events ready, webset.state, webset.strategy, items.changed, reset, complete, reconnect, and error, plus the following events.

`find_more.state`

JSON
{
  "webset_id": "webset-uuid",
  "job_id": "job-uuid",
  "job_status": "running",
  "run_observed": true
}

run_observed=true means the new discovery run for this Find More job has been observed.

`find_more.failed`

JSON
{
  "webset_id": "webset-uuid",
  "job_id": "job-uuid",
  "job_status": "failed",
  "error_code": "webset_find_more_failed"
}

Sent when the job fails or is cancelled before it starts a new run; the stream then closes. If the new run already started, use items.changed and complete as the final outcome.

ready, complete, and reconnect also include find_more_job_id. End normally on complete. On reset, fetch a complete Items snapshot again.