---
title: "PUT /certificates/{certificateId}#newStatus"
method: PUT
path: "/certificates/{certificateId}#newStatus"
---

# PUT /certificates/{certificateId}#newStatus

`PUT /certificates/{certificateId}#newStatus`

Updates the status of the specified certificate. This operation is idempotent.

Requires permission to access the [UpdateCertificate](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

Certificates must be in the ACTIVE state to authenticate devices that use a certificate to connect to IoT.

Within a few minutes of updating a certificate from the ACTIVE state to any other state, IoT disconnects all devices that used that certificate to connect. Devices cannot use a certificate that is not in the ACTIVE state to reconnect.

## Path parameters

- `certificateId` string, required

## Query parameters

- `newStatus` 'ACTIVE' | 'INACTIVE' | 'REVOKED' | 'PENDING_TRANSFER' | 'REGISTER_INACTIVE' | 'PENDING_ACTIVATION', required

## Response `200`

Success

## Other responses

- `480` — ResourceNotFoundException
- `481` — CertificateStateException
- `482` — InvalidRequestException
- `483` — ThrottlingException
- `484` — UnauthorizedException
- `485` — ServiceUnavailableException
- `486` — 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)