rivomiDocs

Statuses

Every state an agent, prospect, run and sequence can be in, and what moves it.

Agent

StateMeaningMoves by
draftCreated, never launched. Finds nobody, sends nothing.rivomi_set_agent_state → live
liveSearching its sources every six hours. Sending too, if outreach is on.→ paused
pausedSearch stopped, every sequence held, nothing cancelled→ live resumes where it stopped
archivedRetired in the appNot reachable from a tool

Prospect

The status filter on rivomi_search_prospects:

StatusMeaning
newFound, not judged yet
qualifiedScored as a fit, waiting to be contacted
contactedInvitation sent
acceptedConnected
repliedWrote back
not_fitRuled out by the targeting
suppressedDo not contact (labelled fit: "not", or on the do-not-contact list)

enriched, scored, drafted, disqualified and screened_out are raw pipeline states and match exactly.

Run

queued → running → done or failed. Poll rivomi_get_run on finished, not status. One failing signal does not fail an agent's run: it is recorded against that signal and the run carries on.

Kinds: sweep (an agent or workspace search), import (a post's engagers), discovery, score (enrich and rate), draft.

Sequence (enrollment)

StateMeaning
queuedAssigned to a sender, waiting for its slot inside working hours and the daily cap
invitedConnection request sent
acceptedThey connected; follow-up messages run on their delays
repliedThey wrote back. The sequence stops and the thread is in the inbox.
doneEvery step sent, no reply
pausedHeld. rivomi_set_enrollment_state → active resumes it exactly where it stopped.
withdrawnStopped with the invitation withdrawn on LinkedIn. Final.
failedCould not proceed (for example, already connected when first-degree connections are excluded)

On this page