Update App
Update domain-specific app metadata overrides. This updates the app instance in your domain, not the shared Lumos app catalog.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
The updated domain-specific display name of the app. Set to null to reset to the app's default name.
The updated domain-specific category of the app. Set to null to reset to the app's default category. Possible values: 'Accounting & Finance', 'Marketing & Analytics', 'Content & Social Media', 'Sales & Support', 'Design & Creativity', 'IT & Security', 'Developers', 'HR & Learning', 'Office & Legal', 'Communication', 'Collaboration', 'Commerce & Marketplaces', 'Other', 'Internal'
The updated domain-specific description of the app. Set to null to reset to the app's default description.
1000The updated domain-specific URL of the logo of the app. Set to null to reset to the app's default logo.
The updated URL of the website of the app. Set to null to clear it.
The updated request instructions.
511Response
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