Skip to main content
GET
Get Appstore App

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

app_id
string
required

Query Parameters

expand
string[] | null

Fields to expand. Supported fields: custom_attributes.

Response

Successful Response

id
string
required

The ID of this app.

app_class_id
string
required

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.

instance_id
string
required

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.

user_friendly_label
string
required

The user-friendly label of this app.

status
enum<string>
required

The status of this app. Possible values: 'DISCOVERED', 'IN_REVIEW', 'NEEDS_REVIEW', 'APPROVED', 'BLOCKLISTED', 'DEPRECATED'

Available options:
DISCOVERED,
IN_REVIEW,
NEEDS_REVIEW,
APPROVED,
BLOCKLISTED,
DEPRECATED
sources
enum<string>[]
required

The sources of this app.

Available options:
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
allow_multiple_permission_selection
boolean
required

Determines whether users can request multiple permissions at once.This field will be removed in subsequent API versions.

disconnected
boolean
required

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

logo_url
string | null

The URL of the logo of this app.

website_url
string | null

The URL of the website of this app.

request_instructions
string | null

The request instructions.

description
string | null

The user-facing description of the app

category
string | null

The category of the app, as shown in the AppStore

sync_status
enum<string> | null

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.

Available options:
SYNCING,
SUCCESS,
FAILED
custom_attributes
Custom Attributes · object | null

Custom attributes configured on the app