---
schema_version: "1"
id: ff48e1b272ae9f64560189928be9cebb21458dfbffa8f9f14066bba92ec2d2db
title: External Client App OAuth Usage
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/meta_external_client_app_oauth_usage.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.meta_external_client_app_oauth_usage.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: c653abc66d8ccf5df62571efd90c0babc058f31cc0da3071d8d0794511e4319b
description: Get External Client App OAuth usage information and revoke tokens through the Connect REST API. The Connect API returns information about the external client apps that users in your org are connecting to, a list of all OAuth users for an app, or the tokens for a given app and user. If you want to revoke access to an external client app, use the Connect API usage resources to revoke a specific token, all tokens associated with an app, or the tokens associated with a specific user.
products:
  - Security
  - Cross Cloud
release: "264"
---
# External Client App OAuth Usage

Get External Client App OAuth usage information and revoke tokens through the Connect REST API. The Connect API returns information about the external client apps that users in your org are connecting to, a list of all OAuth users for an app, or the tokens for a given app and user. If you want to revoke access to an external client app, use the Connect API usage resources to revoke a specific token, all tokens associated with an app, or the tokens associated with a specific user.

When working with connected apps, system admins access usage information through the Usage page in Setup. Usage information is available for external client apps only through the Connect REST API, because external client apps don’t have a UI component.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-identity-264-0-0-production-enus/699dab6f-8f1a-4662-b24f-6521d5b747f7/images/icon_note.png)

Note The Usage resources in the Connect REST API only work for external client apps. These resources aren’t available for connected apps.

## Connect REST API

Access the OAuth Usage resources with [the Connect REST API](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/quickstart.htm). An External Client App admin for a subscriber org doesn’t need any special permissions to access the Usage resources.

## OAuth Usage Features

There are five URIs for OAuth usage in the Connect API. Each of the five endpoints supports either a GET method, a DELETE method, or both a GET and DELETE method. Use these components to monitor app usage and revoke tokens. Details about these resources can be found in the Connect REST API Developer Guide.

  
| URI | Method | Description |
| --- | --- | --- |
| /apps/oauth/usage/ | GET | Lists all the external client apps for the current org. See [OAuth Usage](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_usage.htm). |
| /apps/oauth/usage/<appIdentifier>/users | GET | Lists all users for the external client app indicated by the app ID. See [OAuth Users by App ID](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_usage_app_id_users.htm). |
| /apps/oauth/usage/<appIdentifier>/<userIdentifier>/tokens | GET | Lists all tokens for a user of the external client app. See [Refresh Token by User and App](https://developer.salesforce.com/docs/atlas.en-us.246.0.chatterapi.meta/chatterapi/connect_resources_usage_app_id_user_id_tokens.htm). |
| /apps/oauth/usage/<appIdentifier>/<userIdentifier>/tokens | DELETE | Revokes all tokens for a user of the external client app. See [Refresh Token by User and App](https://developer.salesforce.com/docs/atlas.en-us.246.0.chatterapi.meta/chatterapi/connect_resources_usage_app_id_user_id_tokens.htm). |
| /apps/oauth/usage/<appIdentifier>/tokens | DELETE | Revokes all tokens available for the external client app. See [Refresh Token by App ID](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_usage_app_id_tokens.htm). |
| /apps/oauth/usage/tokens/<tokenIdentifier> | DELETE | Revokes one token. See [OAuth Refresh Token](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_usage_tokens_token_id.htm). |