Skip to main content

LeadDispatchRunListRead

Lead dispatch run enriched with the lead's display name, as returned by the list endpoint.

idIdrequired

Unique numeric identifier of the record.

outreach_campaign_idOutreach Campaign Idrequired

ID of the outreach campaign this run belongs to.

agent_idAgent Idrequired

ID of the agent (a configured AI assistant / bot persona) this record belongs to.

lead_idLead Idrequired

ID of the lead this record relates to.

statusLeadDispatchRunStatusrequired

Run status — active, paused_for_lead_research, paused_for_invitation, replied (the lead answered), exhausted (all steps tried with no reply), cancelled, or superseded (replaced by a newer run).

Possible values: [active, paused_for_lead_research, paused_for_invitation, replied, exhausted, cancelled, superseded]

last_outcome object

Latest planner outcome for this run, such as planned, no_capacity, bad_source, paused_research, or exhausted. Use it to explain why a run is currently waiting or what the scheduler did on its last evaluation.

anyOf
PlanOutcome

Result of one outreach planner evaluation for a dispatch run. It is persisted on the run as the latest scheduler verdict and is intended for debugging why outreach is waiting, paused, blocked by capacity, exhausted, or ready to send.

Possible values: [planned, paused_research, paused_invitation, replied, exhausted, run_not_active, campaign_inactive, pending_attempts, future_slot, no_contacts, no_compatible_channel, no_capacity, window_closed, crm_mismatch, batch_mismatch, bad_source, invitation_skip, send_failed]

last_outcome_at object

When the scheduler last evaluated and stored an outcome for this run (UTC).

anyOf
date-time
started_atdate-timerequired

When the run started (UTC).

finished_at objectrequired

When the run finished (UTC), if it has.

anyOf
date-time
created_atdate-timerequired

Creation time (UTC, ISO 8601).

updated_atdate-timerequired

Last modification time (UTC, ISO 8601).

lead_name object

Display name of the lead this run targets.

anyOf
string
LeadDispatchRunListRead
{
  "id": 0,
  "outreach_campaign_id": 0,
  "agent_id": 0,
  "lead_id": 0,
  "status": "active",
  "last_outcome": "planned",
  "last_outcome_at": "2024-07-29T15:51:28.071Z",
  "started_at": "2024-07-29T15:51:28.071Z",
  "finished_at": "2024-07-29T15:51:28.071Z",
  "created_at": "2024-07-29T15:51:28.071Z",
  "updated_at": "2024-07-29T15:51:28.071Z",
  "lead_name": "string"
}