Delete a Smart List | Sailor API Docs

Deletes the Smart List and its memberships. Calls already in flight retain their immutable dial snapshot.

AuthorizationBearer

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

smartListIdstringRequiredformat: "uuid"

Smart List identifier returned by the create or list operation.

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.

Smart List deleted.

oktrue

deleted_smart_list_idstringformat: "uuid"

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

503

Service Unavailable Error

1	const url = 'https://api.sailorhq.io/smart-lists/smartListId';
2	const options = {
3	method: 'DELETE',
4	headers: {'Idempotency-Key': 'Idempotency-Key', Authorization: 'Bearer <token>'}
5	};
6
7	try {
8	const response = await fetch(url, options);
9	const data = await response.json();
10	console.log(data);
11	} catch (error) {
12	console.error(error);
13	}