Batch-remove members from one Smart List

Marks up to 100 matching memberships removed in one workspace Smart List.

Authentication

AuthorizationBearer

Workspace API key created in Sailor Settings > Integrations > API access.

Path parameters

smartListIdstringRequiredformat: "uuid"

Smart List identifier returned by the create or list operation.

Request

This endpoint expects an object.

memberslist of objectsRequired

reasonstringOptional1-240 characters

Response headers

X-Request-IdstringOptional

Stable request identifier for support and observability.

RateLimit-PolicystringOptional

Versioned structured quota policy. The syntax follows IETF RateLimit draft 11 and may evolve before standardization.

RateLimitstringOptional

Current structured quota state for the authenticated credential.

Idempotent-ReplayedstringOptional

True when this exact response was replayed from a completed idempotency record.

Response

Batch processed.

oktrue

skippedinteger0-9007199254740991

unmatchedinteger0-9007199254740991

insertedintegerOptional0-9007199254740991

removedintegerOptional0-9007199254740991

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

413

Content Too Large Error

415

Unsupported Media Type Error

422

Unprocessable Entity Error

429

Too Many Requests Error

503

Service Unavailable Error

1	const url = 'https://api.sailorhq.io/smart-lists/smartListId/members/batch-remove';
2	const options = {
3	method: 'POST',
4	headers: {
5	'Idempotency-Key': 'Idempotency-Key',
6	Authorization: 'Bearer <token>',
7	'Content-Type': 'application/json'
8	},
9	body: '{"members":[{"contact_id":"00000000-0000-4000-8000-000000000031"}],"reason":"lead_disqualified"}'
10	};
11
12	try {
13	const response = await fetch(url, options);
14	const data = await response.json();
15	console.log(data);
16	} catch (error) {
17	console.error(error);
18	}

1	{
2	"ok": true,
3	"skipped": 0,
4	"unmatched": 0,
5	"removed": 1
6	}