Skip to content

Delete whitelist suppressions

DELETE
/api/domains/{domain}/suppressions/whitelist
curl --request DELETE \
--url https://smtp-app.kirim.email/api/domains/example.com/suppressions/whitelist \
--header 'Authorization: Basic <credentials>' \
--header 'Content-Type: application/json' \
--data '{ "ids": [ 1, 2, 3 ] }'

Remove whitelist suppressions by IDs

domain
required
string
Example
example.com

Domain name that must be owned by the authenticated user. The domain must be verified and properly configured for email sending.

Media typeapplication/json
object
ids
required

Array of suppression IDs to delete

Array<integer>
Example
[
1,
2,
3
]

Suppressions deleted successfully

X-RateLimit-Limit
integer

Maximum requests per minute

X-RateLimit-Remaining
integer

Remaining requests in current window

Unauthorized - Invalid or missing authentication credentials

Media typeapplication/json
object
success
boolean
message
string
Example
{
"success": false,
"message": "Unauthorized"
}

Validation Error - Invalid input data

Media typeapplication/json
object
success
boolean
message
string
errors

Field-specific validation errors

object
Example
{
"success": false,
"message": "Validation failed."
}

Too Many Requests - Rate limit exceeded. Retry after the specified time.

Media typeapplication/json
object
success
boolean
message
string
Example
{
"success": false,
"message": "Too many attempts. Please try again later."
}
Retry-After
integer

Seconds until rate limit resets

X-RateLimit-Limit
integer

Maximum requests per minute

X-RateLimit-Remaining
integer

Remaining requests in current window

Server Error - Unexpected error occurred

Media typeapplication/json
object
success
boolean
message
string
Example
{
"success": false,
"message": "An error occurred while processing the request."
}