ArgorantDocs

Unblock many addresses or domains

posthttps://app.argorant.com/api/v1/blocklist/bulk-remove
POST
/api/v1/blocklist/bulk-remove

Up to 5,000 email addresses or domains.

CSV text instead of values, up to 5,000 rows.

Up to 5,000 entry ids from the list.

Remove only these campaigns' entries, up to 50.

true only counts and changes nothing.

Removes up to 5,000 entries per call, by values (or csv) or by entry ids. Without campaign_ids it removes workspace entries (and campaign entries named by id); with campaign_ids only those campaigns' entries. dry_run: true only counts. People who were stopped by an entry are not added back on their own.

CostWhat it doesKey scopes
FreeWritesargorant:manage_lists

Authorization

BearerAuth
AuthorizationBearer <token>

Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>. A connector sign-in token (ag_mcp_...) works the same way.

In: header

Header Parameters

Idempotency-Key?string

Any unique text up to 128 characters. A retry with the same key and the same body within 24 hours returns the first answer (with the header Idempotent-Replayed: true) instead of doing the work twice. The same key with another body answers 409 idempotency_conflict.

Lengthlength <= 128
X-Request-Id?string

Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.

Match^[A-Za-z0-9._-]{8,64}$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Shell
curl -X POST "https://app.argorant.com/api/v1/blocklist/bulk-remove" \  -H "Idempotency-Key: 6f1c2e7a-run-42" \  -H "Content-Type: application/json" \  -d '{    "values": [      "competitor.com"    ],    "dry_run": false  }'
JSON
{  "ok": true,  "dry_run": false,  "found": 1,  "invalid": 0,  "invalid_examples": [],  "removed": 1,  "not_listed": 0,  "scope": "workspace",  "summary": "Removed 1 entries. People stopped earlier are not added back on their own."}