---
title: "PATCH /transfer-certificate/{certificateId}#targetAwsAccount"
method: PATCH
path: "/transfer-certificate/{certificateId}#targetAwsAccount"
---

# PATCH /transfer-certificate/{certificateId}#targetAwsAccount

`PATCH /transfer-certificate/{certificateId}#targetAwsAccount`

Transfers the specified certificate to the specified Amazon Web Services account.

Requires permission to access the [TransferCertificate](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) 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 UpdateCertificate action to deactivate it.

The certificate must not have any policies attached to it. You can use the DetachPolicy action to detach them.

## Path parameters

- `certificateId` string, required

## Query parameters

- `targetAwsAccount` string, required

## Request body

- object
  - `transferMessage` string — The transfer message.

## Response `200`

Success

- TransferCertificateResponse — The output from the TransferCertificate operation.
  - `transferredCertificateArn` string — The ARN of the certificate.

## Other responses

- `480` — InvalidRequestException
- `481` — ResourceNotFoundException
- `482` — CertificateStateException
- `483` — TransferConflictException
- `484` — ThrottlingException
- `485` — UnauthorizedException
- `486` — ServiceUnavailableException
- `487` — InternalFailureException

---

[API](https://skmtc.net/aws/apis/iot.md) · [All operations](https://skmtc.net/aws/apis/iot/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iot/revisions/deef5c4b09f0/schema)