PATCH

/transfer-certificate/{certificateId}#targetAwsAccount

http://iot.{region}.amazonaws.com/transfer-certificate/{certificateId}#targetAwsAccount

Transfers the specified certificate to the specified Amazon Web Services account. Requires permission to access the <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions">TransferCertificate</a> action. You can cancel the transfer until it is acknowledged by the recipient. No notification is sent to the transfer destination's account. It is up to the caller to notify the transfer target. The certificate being transferred must not be in the ACTIVE state. You can use the <a>UpdateCertificate</a> action to deactivate it. The certificate must not have any policies attached to it. You can use the <a>DetachPolicy</a> action to detach them.

Access Token Required: API Key

Path Parameters

certificateIdstringrequired

The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

Query Params

targetAwsAccountstringrequired

The Amazon Web Services account.

Body Params

transferMessagestring

The transfer message.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request PATCH \
2     --url 'http://iot.{region}.amazonaws.com/transfer-certificate/{certificateId}#targetAwsAccount' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}