Get OAuth App

Retrieves an OAuth App by ID or client ID.

URLRequires AuthHTTP Method

/api/v1/oauth-apps.get

GET

Permission required: manage-oauth-apps

Query Parameters

KeyExample ValueDescription

appId

jn32kjnnd0943j4njk

The app's ID. This value is required if clientId is not used.

clientId

nkn8jk67b8b99b78

The client's ID. This value is required if the appId is not used.

Example

curl -H "X-Auth-Token: 9HqLlyZOugoStsXCUfD_0YdwnNnunAJF8V47U3QHXSq" \
     -H "X-User-Id: aobEdbYhXfu5hkeqG" \
     http://localhost:3000/api/v1/oauth-apps.get?appId=jn32kjnnd0943j4njk

Example Response

{
  "oauthApp": {
    "_id": "zapier",
    "name": "Zapier",
    "active": true,
    "clientId": "zapier",
    "clientSecret": "RTK6TlndaCIolhQhZ7_KHIGOKj41RnlaOq_o-7JKwLr",
    "redirectUri": "https://zapier.com/dashboard/auth/oauth/return/RocketChatDevAPI/",
    "_createdAt": "2019-10-17T22:55:32.787Z",
    "_createdBy": {
      "_id": "system",
      "username": "system"
    },
    "_updatedAt": "2019-10-17T22:55:32.787Z"
  },
  "success": true
}

Change Log

VersionDescription

2.4.0

Added

Last updated

Rocket.Chat versions receive support for six months after release.