Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

DisassociateEmailIdentityCertificate

Removes the association between an S/MIME certificate and an email identity. After the association is removed, Amazon SES API v2 stops adding an S/MIME signature to messages sent from that address.

If the email identity is a domain, specify the FromAddress whose certificate association you want to remove.

This operation is idempotent. If the specified email identity exists but there's no matching certificate association, the operation succeeds without making any changes. Amazon SES API v2 returns a NotFoundException only when the specified email identity doesn't exist.

Request Syntax


POST /v2/email/identity/certificates/delete HTTP/1.1
Content-type: application/json

{
   "EmailIdentity": "string",
   "FromAddress": "string"
}

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.

EmailIdentity

The email identity whose certificate association you want to remove.

Type: String

Length Constraints: Minimum length of 1.

Required: Yes

FromAddress

The email address whose certificate association you want to remove. This value is required when the email identity is a domain. When the email identity is an email address, this value is optional.

Type: String

Required: No

Response Syntax


HTTP/1.1 200

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors

For information about the errors that are common to all actions, see Common Error Types.

BadRequestException

The input you provided is invalid.

HTTP Status Code: 400

NotFoundException

The resource you attempted to access doesn't exist.

HTTP Status Code: 404

TooManyRequestsException

Too many requests have been made to the operation.

HTTP Status Code: 429