# POST /event-queues/:queue_id/remove-enrollment

**Resource:** [Auto Queues](./auto-queues.md)  
**MCP tool:** `remove_from_auto_queue`  
**Scopes:** `automations:write`  
**Write operation:** yes

Remove a contact or deal from an auto queue (drip sequence) by cancelling their pending steps. Pass queue_id plus ONE of: enrollment_id (most precise — from get_auto_queue_board cards or list_auto_queue_enrollments), contact_id, or deal_id. This is the direct unenrol — no need to build, enable, and trigger a remove_from_event_queue automation. Returns cancelled_count (the real number of pending steps stopped) and a message; cancelled_count: 0 with an explanatory message means nothing was pending for that enrolment (already completed, already removed, or never enrolled).

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `queue_id` | path | string | yes | The auto queue UUID. |
| `enrollment_id` | body | string | no | Preferred. The enrolment UUID from the board or enrollments list. |
| `contact_id` | body | string | no | Cancel this contact's pending steps in the queue. |
| `deal_id` | body | string | no | Cancel this deal's pending steps in the queue. |

## Request example

```bash
curl -X POST   "https://api.trustpager.com/functions/v1/api/v1/event-queues/:queue_id/remove-enrollment"   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"enrollment_id":"...","contact_id":"...","deal_id":"..."}'
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`