Delete OAuth Client

DELETE /port1/{principalType}/{principalId}/oauth-clients/{clientId}

Deletes an OAuth client. This permanently removes the OAuth client and invalidates all associated tokens. This action cannot be undone.

Requires a signed user/session or the existing authenticated client flow. The anonymous DCR delegated device profile cannot invoke this operation.

Required scope

Any authenticated access token

principalTypestringRequired: The type of principal that owns the OAuth client
principalIdstringRequired: The ID of the principal that owns the OAuth client
clientIdstringRequired: The ID of the OAuth client to delete

OAuth client deleted successfully

No response body.

400

Invalid request payload

Check the request fields and any validation details, then correct the payload.

401

Unauthorized - invalid or missing authentication token

Obtain a valid access token, then retry.

404

OAuth client not found

Verify the target identifier and that its endpoint or plugin route still exists.

500

Internal server error

Retry with backoff only when the operation is safe to repeat. Include the error code when reporting persistent failures.