> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cocoondata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# <access-service>/api/v1/users/me/applications/approvals/{approvalId}

## URL structure&#x20;

```text theme={null}
https://access-service.xy-company.com/api/v1/users/me/applications/approvals/{approvalId}
```

where `{approvalId}` is an application's approval ID.

## Supported methods and overview&#x20;

* `DELETE` - used to revoke the access that a third party (i.e. non-Covata) client application has to resources on the Covata Platform (which are available to the currently authenticated [Covata user](/2.16/admin/administering-users.md)<sup>\*</sup>), based on the application's approval ID.

> [!NOTE]
>
> This method takes no parameters.

## Detailed description&#x20;

This API endpoint revokes the access that a third party (i.e. non-Covata) client application has to resources on the Covata Platform (which are available to the currently authenticated Covata user<sup>\*</sup>), based on this application's approval ID. This Covata user would have previously permitted the application access to their resources on the Covata Platform.

An application's approval ID is obtained by calling the [\<access-service>/api/v1/users/me/applications/approvals](/2.16/api/access-service-api-v1-users-me-applications-approvals.md) API endpoint, which retrieves a list of information about all client applications that the currently authenticated Covata user has approved access to their resources on the Covata Platform.

Such a client application could be one that you or your organization is developing, where this application integrates with Covata technologies either using Covata's API or a Covata SDK.

> [!NOTE]
>
> Before any client application can be granted access to a Covata user's resources, a Covata Platform administrator must first have [registered the client application](/2.16/api/access-service-api-v1-clientapps.md) on their Covata Platform.

## Supported roles&#x20;

This API endpoint supports the following Covata user [roles](/2.16/admin/administering-users.md#a-users-roles) (as described in the [Covata Platform Administrator's Guide](/2.16/admin.md)):

* [Originator](/2.16/admin/administering-users.md#originator-role)
* [Collaborator](/2.16/admin/administering-users.md#collaborator-role)

The Covata Platform's resources available to one of these Covata users (above) is determined by the access token passed in the [header](/2.16/api/access-service-api-v1-users-me-applications-approvals-approvalid.md#access-service-api-v1-users-me-applications-approvals-approvalid-required-headers) of requests to this endpoint.

## Required headers&#x20;

The appropriate access token as the `Bearer` token:

* `Authorization: Bearer a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6`

## Returns&#x20;

If the request succeeded, then an HTTP response status `200 OK` is returned.

<sup>\*</sup> The currently authenticated user is determined by the access token passed in the [header](/2.16/api/access-service-api-v1-users-me-applications-approvals-approvalid.md#access-service-api-v1-users-me-applications-approvals-approvalid-required-headers) of requests to this endpoint.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.