Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.msgflash.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

POST /api/v1/contacts/bulk-delete

​
Body

FieldTypeRequiredDescription
contactIdsUUID[]yes1 to 10000 IDs

​
Success response 200

{
  "data": {
    "requested": 2,
    "deleted": 1,
    "notFound": ["cnt_missing"]
  }
}

​
Async response 202

When contactIds.length >= 100, the operation runs in background. 
{
  "data": {
    "mode": "async",
    "jobId": "job_abc123",
    "status": "pending",
    "operation": "bulk_delete_contacts",
    "requestedCount": 900,
    "progress": 0,
    "message": "Bulk operation queued. Check status via GET /api/contacts/bulk-jobs/job_abc123"
  }
}

​
Notes

  • < 100 contacts: synchronous response
  • >= 100 contacts: asynchronous response with HTTP 202
  • Poll GET /api/v1/contacts/bulk-jobs/{jobId}/progress every 2s