Get App
Get an app by id.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
Fields to expand. Supported fields: custom_attributes.
Response
Successful Response
The ID of this app.
The non-unique ID of the service associated with this requestable permission. Depending on how it is sourced in Lumos, this may be the app's name, website, or other identifier.
The non-unique ID of the instance associated with this app. This will be the Okta app id if it’s an Okta app, or will be marked as custom_app_import if manually uploaded into Lumos.
The user-friendly label of this app.
The status of this app. Possible values: 'DISCOVERED', 'IN_REVIEW', 'NEEDS_REVIEW', 'APPROVED', 'BLOCKLISTED', 'DEPRECATED'
DISCOVERED, IN_REVIEW, NEEDS_REVIEW, APPROVED, BLOCKLISTED, DEPRECATED The sources of this app.
GSUITE_QUICK_INBOX, GSUITE_DEEP_INBOX, MICROSOFT_DEEP_INBOX, MICROSOFT_OAUTH, MICROSOFT_GCC, GSUITE_OAUTH, OKTA, MANUAL, ONELOGIN, ATLASSIAN, GOOGLE_CLOUD, LUMOS_INTEGRATION, JUMPCLOUD, CUSTOM, MCP Determines whether users can request multiple permissions at once.This field will be removed in subsequent API versions.
Whether this app has been disconnected (its stored credentials removed via DELETE /apps/{app_id}). A disconnected app is excluded from GET /apps?disconnected=false; reconnect it with PUT /apps/{app_id}.
A collection of URLs related to this application
The URL of the logo of this app.
The URL of the website of this app.
The request instructions.
The user-facing description of the app
The category of the app, as shown in the AppStore
The state of this app's most recent sync: SYNCING while one is running, SUCCESS or FAILED once it finished. Poll this after POST /apps/{app_id}/sync to follow that sync. null when no sync result is recorded — the app has never synced, or was disconnected.
SYNCING, SUCCESS, FAILED Custom attributes configured on the app