Skip to main content
DELETE
/
api
/
adm
/
identityServerClients
/
{id}
Delete IdentityServer Client
curl --request DELETE \
  --url https://localhost:44371/api/adm/identityServerClients/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "code": 200,
  "errorMessage": null
}

​
Description

Permanently removes an IdentityServer4 client configuration. This operation should be performed with caution as it prevents the client application from authenticating. Existing tokens continue working until expiration, but token refresh will fail after deletion.

​
Input

  • Path Parameter: id (guid, required) — Unique identifier of the client to delete.

​
Output

Returns a IdentityServerClientDeleteCommandResponse indicating deletion success.

​
Example Request

DELETE /api/admin/identityServerClients/7bc94a21-8833-4d2f-a5e1-9f4b2d8c1e7a
Authorization: Bearer {token}

​
Example Response

{
  "success": true,
  "code": 200,
  "errorMessage": null
}

​
Errors

  • 400 Bad Request — Cannot delete active client with active sessions or dependencies.
  • 404 Not Found — No client exists with the specified ID.
  • 401 Unauthorized — Missing or invalid authentication token.
  • 403 Forbidden — User does not have permission to delete clients.

​
Notes

  • Existing tokens issued to this client continue working until expiration.
  • Token refresh will fail for this client after deletion.
  • Consider disabling the client first (via Update) before permanent deletion.
  • Notify affected users and applications before deleting production clients.
  • Verify no active sessions are using this client before deletion.
  • Document the reason for deletion for audit purposes.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
id
string<guid>
required

The unique identifier of the client to delete.

Response

Returns success when the client is deleted successfully.

Standard response structure containing operation status and error information. Standard command response indicating the result of a data modification. Represents the response returned after deleting an identity server client.

​
success
boolean

True if the operation completed successfully; false if an error occurred.

Example:

true

​
code
enum<string>

Result code indicating the outcome of the operation.

Available options:
Unknown,
Success,
BadRequest,
Unauthorized,
NotFound,
Error
Example:

200

​
errorMessage
string | null

Human-readable error message when an error occurs.

Example:

null