blacklist/get_emails
Tool: read
List all blacklisted email addresses with optional text search and pagination.
Returns a paginated list of email blacklist entries. Each entry has a blockId needed for deletion.
Arguments
| name | type | req | notes |
|---|---|---|---|
| search | string | – | Filter by email text |
| page | integer | – | Page number, 1-indexed (default 1) |
| limit | integer | – | limit default 30, max 30; see schemas/pagination |
| startingAfter | integer | – | Cursor for next page (int64) |
Response
200 — Paginated list; object: {items: BlacklistEmail[], pagination}. Deltas: none.
| field | type | constraints | description |
|---|---|---|---|
| items[].blockId | integer | int64 | Use this id to delete the entry via blacklist/delete_emails_by_id. |
| items[].email | string | Blacklisted email address. | |
| items[].createdAt | string | date-time | When it was added. |
Pagination: see schemas/pagination.
Errors: 400, 401, 406, 422, 429, 500 — shared schema: schemas/errors.
Invoke
Call read with name: "blacklist/get_emails".