Bulk delete leads - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

This returns a queue receipt. Poll the operation run with operation_run_id (requires jobs:read) to confirm completion. The authenticated organization determines the selection scope. Explicit IDs are trimmed and deduplicated, then capped at 5,000 after any selection limit; inaccessible or missing explicit IDs are rejected. Descriptor selections are resolved by the background job, so initial requested/matched counts can be null. Pending outreach is stopped before records are removed; enrollment, task and delivery audit history is retained.

Body parameters

lead_ids · optional
array<string>
Explicit lead IDs to delete. Provide either lead_ids or selection.
selection · optional
object
Bulk selection object with mode (ids or descriptor), descriptor filter, search, scope, etc.
scope · optional
string
Lead scope: org or user.
source_table_id · optional
string
Research table context for descriptor selection.
source_table_scope · optional
string
Research scope: company or lead.

Name	Type	Description
lead_ids	array<string>	Explicit lead IDs to delete. Provide either lead_ids or selection.
selection	object	Bulk selection object with mode (ids or descriptor), descriptor filter, search, scope, etc.
scope	string	Lead scope: org or user.
source_table_id	string	Research table context for descriptor selection.
source_table_scope	string	Research scope: company or lead.

Errors

Status	Meaning
400	Invalid payload or some leads not found.
401	Invalid API key or missing auth.
403	Missing leads:write scope.
404	No leads found for selection.

Example

bash

curl -X POST "https://app.autotouch.ai/api/leads/delete" \
    -H "Authorization: Bearer stk_your_key_id.your_secret" \
    -H "Content-Type: application/json" \
    -d '{"lead_ids":["67c4b113b4dd8f2d4999f0f1","67c4b113b4dd8f2d4999f0f2"]}'

Request body

json

{
    "lead_ids": ["67c4b113b4dd8f2d4999f0f1", "67c4b113b4dd8f2d4999f0f2"]
  }

Response example

json

{
    "success": true,
    "status": "queued",
    "job_id": "job_123",
    "operation_run_id": "run_123",
    "operationRunId": "run_123",
    "requested_count": 2,
    "matched_count": 2,
    "deleted_count": 0,
    "message": "Lead deletion queued. Outreach will be stopped before records are removed."
  }