Recycle Lead - Qall Voice AI Docs

Resets a lead back to pending state so it will be picked up by the scheduler again. Only leads in completed, failed, or canceled state can be recycled.

Path Parameters

Parameter	Type	Description
`lead_id`	integer	The lead ID.

Query Parameters

Parameter	Type	Default	Description
`reset`	boolean	`false`	If `true`, resets `attempt_count`, `last_outcome`, and `last_attempt_at` to their initial values. If `false`, only the state is changed to `pending` and the existing attempt history is preserved.

Response

Returns the full updated lead object with state: "pending". With reset=true:

{
  "success": true,
  "data": {
    "id": 42,
    "campaign_id": 1,
    "name": "Jane Smith",
    "phone_number": "+15559876543",
    "lead_timezone": "America/Chicago",
    "custom_vars": {
      "company": "Acme Corp",
      "deal_stage": "proposal"
    },
    "state": "pending",
    "attempt_count": 0,
    "last_outcome": null,
    "last_attempt_at": null,
    "created_at": "2025-01-10T15:00:00",
    "updated_at": "2025-01-22T08:00:00"
  }
}

With reset=false (default):

{
  "success": true,
  "data": {
    "id": 42,
    "campaign_id": 1,
    "name": "Jane Smith",
    "phone_number": "+15559876543",
    "lead_timezone": "America/Chicago",
    "custom_vars": {
      "company": "Acme Corp",
      "deal_stage": "proposal"
    },
    "state": "pending",
    "attempt_count": 2,
    "last_outcome": "no_answer",
    "last_attempt_at": "2025-01-17T15:30:00",
    "created_at": "2025-01-10T15:00:00",
    "updated_at": "2025-01-22T08:00:00"
  }
}