# Delete a CIMD Client Registration API

API documentation for the FusionAuth Delete a CIMD Client Registration API.

> For the index of this section of the site, see [llms.txt](https://fusionauth.io/docs/llms.txt)

> **PLAN:** This feature requires [an Enterprise plan](https://fusionauth.io/docs/get-started/core-concepts/plans-features.md#enterprise-features).

Available since `1.70.0`

This API is used to delete a CIMD client registration. You must specify the Id of the registration on the URI.

Caution

This is always a permanent, hard delete and cannot be reversed. Deleting a registration also deletes the client's refresh tokens.

Deleting a registration doesn't block the client. The next time a user logs in with the client, FusionAuth fetches its metadata document and registers it again. To keep a client out, set the `decision` to `DENY` for it in the CIMD domain's [registration lambda](https://fusionauth.io/docs/extend/code/lambdas/cimd-client-registration.md). See [Removing A CIMD Client](https://fusionauth.io/docs/lifecycle/authenticate-users/oauth/client-registration.md#removing-a-cimd-client).

## Request

[API Key Authentication](https://fusionauth.io/docs/apis/authentication.md#api-key-authentication)

Permanently delete a CIMD Client Registration. This operation cannot be reversed.

`DELETE /api/cimd/registration/{registrationId}`

#### Request Headers

`X-FusionAuth-TenantId`

*   Type: `String`
*   Optional

The unique Id of the tenant used to scope this API request.

The tenant Id is not required on this request even when more than one tenant has been configured because the tenant can be identified based upon other values in the request or it is otherwise not required.

Specify a tenant Id on this request when you want to ensure the request is scoped to a specific tenant. The tenant Id may be provided through this header or by using a tenant locked API key to achieve the same result.

See [Making an API request using a Tenant Id](https://fusionauth.io/docs/apis/authentication.md#making-an-api-request-using-a-tenant-id) for additional information.

### Request Parameters

`registrationId`

*   Type: `UUID`
*   Required

The Id of the CIMD client registration to delete.

## Response

This API does not return a JSON response body.

*Response Codes*

| Code | Description |
| --- | --- |
| 200 | The request was successful. |
| 400 | The request was invalid and/or malformed. The response will contain an [Errors](https://fusionauth.io/docs/apis/errors.md) JSON Object with the specific errors. This status will also be returned if a paid FusionAuth license is required and is not present. |
| 401 | You did not supply a valid Authorization header. The header was omitted or your API key was not valid. The response will be empty. See [Authentication](https://fusionauth.io/docs/apis/authentication.md). |
| 404 | The object you requested doesn't exist. The response will be empty. |
| 500 | There was an internal error. A stack trace is provided and logged in the FusionAuth log files. The response will be empty. |
---

## Other pages in Cimd Client Registrations

> For the full index of this section, see [Apis](https://fusionauth.io/docs/llms-apis.txt).

- [CIMD Client Registration API](https://fusionauth.io/docs/apis/cimd-client-registrations.md): Learn about the APIs for retrieving, searching for, and deleting CIMD client registrations.
- [Retrieve a CIMD Client Registration API](https://fusionauth.io/docs/apis/cimd-client-registrations/retrieve-a-cimd-client-registration.md): API documentation for the FusionAuth Retrieve a CIMD Client Registration API.
- [Search for CIMD Client Registrations API](https://fusionauth.io/docs/apis/cimd-client-registrations/search-for-cimd-client-registrations.md): API documentation for the FusionAuth Search for CIMD Client Registrations API.