:original_name: DeleteAuthorizations.html
.. _DeleteAuthorizations:
Deleting Authorization
======================
Function
--------
This API is used to delete the authorization of a specified user or all users.
URI
---
DELETE /v2/{project_id}/authorizations
.. table:: **Table 1** Path Parameters
+------------+-----------+--------+------------------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+============+===========+========+==================================================================================================================+
| project_id | Yes | String | Project ID. For details about how to obtain a project ID, see :ref:`Obtaining a Project ID `. |
+------------+-----------+--------+------------------------------------------------------------------------------------------------------------------+
.. table:: **Table 2** Query Parameters
+-----------+-----------+--------+------------------------------------------------------------------------------------------------------+
| Parameter | Mandatory | Type | Description |
+===========+===========+========+======================================================================================================+
| user_id | No | String | User ID. If **user_id** is set to **all-users**, the authorization of all IAM users will be deleted. |
+-----------+-----------+--------+------------------------------------------------------------------------------------------------------+
Request Parameters
------------------
None
Response Parameters
-------------------
None
Example Requests
----------------
Delete the authorization of a specified user.
.. code-block:: text
DELETE https://{endpoint}/v2/{project_id}/authorizations?user_id=****d80fb058844ae8b82aa66d9fe****
Example Responses
-----------------
**Status code: 200**
OK
.. code-block::
{
"result" : "true"
}
Status Codes
------------
=========== ============
Status Code Description
=========== ============
200 OK
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
=========== ============
Error Codes
-----------
See :ref:`Error Codes `.