Delete domain

DELETE

/api/domains/{domain}

const url = 'https://smtp-app.kirim.email/api/domains/example.com';
const options = {method: 'DELETE', headers: {Authorization: 'Basic <credentials>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://smtp-app.kirim.email/api/domains/example.com \
  --header 'Authorization: Basic <credentials>'

Remove a domain from the authenticated user’s account

Authorizations

basicAuth

Parameters

Path Parameters

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.

Responses

204

Domain deleted successfully

Headers

X-RateLimit-Limit

integer

Maximum requests per minute

X-RateLimit-Remaining

integer

Remaining requests in current window

401

Unauthorized

application/json

object

error

Error type indicating authentication failure

string

message

Human-readable error message explaining the authentication issue

string

Example

{
  "error": "Unauthorized",
  "message": "Authorization header is required"
}

404

Domain not found

application/json

object

success

boolean

message

string

Example

{
  "success": false,
  "message": "Domain not found"
}

429

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

application/json

object

success

boolean

message

string

Example

{
  "success": false,
  "message": "Too many attempts. Please try again later."
}

Headers

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