Skip To Content

/apps/[clientID]: Registered App

  • URL:https://[root]oauth2/apps/[clientID](POST only)

Example usage

URL for Registerd App

https://www.arcgis.com/sharing/rest/oauth2/apps/GGjeDjEY6kKEiDmX

Description

An app registered with the portal. An app item can be registered by invoking the register app operation. Every registered app gets an App ID and App Secret which in OAuth speak are known as client_id and client_secret respectively.

The app owner has access to the registered app resource. This would include the organization administrator as well.

Request Parameters

ParameterDetails
[Common Parameters]

For a complete listing, see Common parameters.

Response Properties

PropertyDetails
client_id

The ID of the registered application. Also referred to as APPID.

client_secret

The secret of the registered application. Also referred to as APPSECRET.

appType

The type of app that was registered indicating whether it's a browser app, native app, server app or a multiple interface app.

Values: browser | native | server| multiple

Example: appType=browser

redirect_uris

The URIs where the access_token or authorization code will be delivered to upon successful authorization. The redirect_uri specified during authorization must be match one of the registered URIs otherwise authorization will be rejected.

A special value of urn:ietf:wg:oauth:2.0:oob can also be specified for authorization grants. This will result in the authorization code being delivered to a portal URL (/oauth2/approval). This value is typically used by applications that don't have a web server or a custom URI scheme to deliver the code to.

The value is a JSON string array.

Example:

[
  "https://app.foo.com",
  "urn:ietf:wg:oauth:2.0:oob"
]

created

The date when the app was created (in UNIX time in milliseconds).

modified

The date when the app was last modified (in UNIX time in milliseconds).

JSON Response syntax


{
  "itemId": "<itemId>",
  "client_id": "<client_id>",
  "client_secret": "<client_secret>",
  "appType": "<appType>",
  "redirect_uris": [
    "<redirect_uri1>",
    "<redirect_uri2>"
  ],
  "registered": <registered>,
  "modified": <modified>
}

JSON Response example

{
  "itemId": "e52db2cdc16640a0b1c69727abdf48c8",
  "client_id": "GGjeDjEY6kKEiDmX",
  "client_secret": "e2b8958384c74d3a9f09e988d782b473",
  "appType": "browser",
  "redirect_uris": [
    "https://*.arcgis.com",
    "urn:ietf:wg:oauth:2.0:oob"
  ],
  "registered": 1380561095000,
  "modified": 1380561095000
}