Permanently revokes the API key. Any subsequent requests using this key will receive a 401 Unauthorized response. This action cannot be undone.

Authorization

BearerAuth

AuthorizationBearer <token>

API key passed as a Bearer token. Production keys start with am_live_ and sandbox keys start with am_test_.

In: header

Path Parameters

key_id*string

The unique API key ID (prefixed with key_).

curl -X DELETE "https://secureagentmail.com/api/v1/api_keys/string"

Empty

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key.",
    "status": 401
  }
}

{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found.",
    "status": 404
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Please retry after 30 seconds.",
    "status": 429
  }
}