/okta-apps | Type: Application | PCID required: Yes
Tools
okta-apps_activate_application
Activate an application Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | — | Application ID |
okta-apps_assign_group_to_application
Assign an application group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | — | Application ID |
groupId | string | Yes | — | The id of the group |
_embedded | object | No | — | Embedded resource related to the Application Group using the JSON Hypertext Application Language specification. If the expand=group query parameter is specified, then the group object is embedded. If the expand=metadata query parameter is specified, then the group assignment metadata is embedded. |
_links | object | No | — | The links value |
id | string | No | — | ID of the group |
lastUpdated | object | No | — | Last Updated |
priority | integer | No | — | Priority assigned to the group. If an app has more than one group assigned to the same user, then the group with the higher priority has its profile applied to the application user. If a priority value isn’t specified, then the next highest priority is assigned by default. See Assign attribute group priority and the sample priority use case. |
profile | object | No | — | Specifies the profile properties applied to application users that are assigned to the app through group membership. Some reference properties are imported from the target app and can’t be configured. See profile. |
okta-apps_assign_user_to_application
Assign an application user Parameters:| Parameter | Type | Required | Default | Description | |
|---|---|---|---|---|---|
appId | string | Yes | — | Application ID | |
_embedded | object | No | — | Embedded resources related to the application user using the JSON Hypertext Application Language specification | |
_links | object | No | — | Specifies link relations (see Web Linking) available using the JSON Hypertext Application Language specification. This object is used for dynamic discovery of resources related to the application user. | |
created | object | No | — | The created value | |
credentials | object | No | — | Specifies a user’s credentials for the app. This parameter can be omitted for apps with sign-on mode (signOnMode) or authentication schemes (credentials.scheme) that don’t require credentials. | |
externalId | string | No | — | The ID of the user in the target app that’s linked to the Okta application user object. This value is the native app-specific identifier or primary key for the user in the target app. The externalId is set during import when the user is confirmed (reconciled) or during provisioning when the user is created in the target app. This value isn’t populated for SSO app assignments (for example, SAML or SWA) because it isn’t synchronized with a target app. | |
id | string | Yes | — | Unique identifier for the Okta user | |
lastSync | string | No | — | Timestamp of the last synchronization operation. This value is only updated for apps with the IMPORT_PROFILE_UPDATES or PUSH PROFILE_UPDATES feature. | |
lastUpdated | object | No | — | Last Updated | |
passwordChanged | string | null | No | — | Timestamp when the application user password was last changed |
profile | object | No | — | Specifies the default and custom profile properties for a user. Properties that are visible in the Admin Console for an app assignment can also be assigned through the API. Some properties are reference properties that are imported from the target app and can’t be configured. See profile. | |
scope | string | No | — | Indicates if the assignment is direct (USER) or by group membership (GROUP). If not specified, Okta tries to determine the scope based on the assignment type. | |
status | string | No | — | Status of an application user | |
statusChanged | string | No | — | Timestamp when the application user status was last changed | |
syncState | string | No | — | The synchronization state for the application user. The application user’s syncState depends on whether the PROFILE_MASTERING feature is enabled for the app. > Note: User provisioning currently must be configured through the Admin Console. |
okta-apps_create_application
Create an application Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
activate | boolean | No | — | Executes activation lifecycle operation when creating the app |
OktaAccessGateway-Agent | string | No | — | Okta Access Gateway-agent |
_embedded | object | No | — | Embedded resources related to the app using the JSON Hypertext Application Language specification. If the expand=user/{userId} query parameter is specified, then the assigned Application User is embedded. |
_links | object | No | — | Discoverable resources related to the app |
accessibility | object | No | — | Specifies access settings for the app |
created | string | No | — | Timestamp when the application object was created |
expressConfiguration | object | No | — | <div class=“x-lifecycle-container”><x-lifecycle class=“oie”></x-lifecycle></div> Indicates which Express Configuration capabilities the app supports and has enabled |
features | string[] | No | — | Enabled app features > Note: See Application Features for app provisioning features. |
id | string | No | — | Unique ID for the app instance |
label | string | Yes | — | User-defined display name for app |
lastUpdated | string | No | — | Timestamp when the application object was last updated |
licensing | object | No | — | Licenses for the app |
orn | string | No | — | The Okta resource name (ORN) for the current app instance |
profile | object | No | — | Contains any valid JSON schema for specifying properties that can be referenced from a request (only available to OAuth 2.0 client apps). For example, add an app manager contact email address or define an allowlist of groups that you can then reference using the Okta Expression Language getFilteredGroups function. > Notes: > * profile isn’t encrypted, so don’t store sensitive data in it. > * profile doesn’t limit the level of nesting in the JSON schema you created, but there is a practical size limit. Okta recommends a JSON schema size of 1 MB or less for best performance. |
signOnMode | string | Yes | — | Authentication mode for the app | signOnMode | Description | | ---------- | ----------- | | AUTO_LOGIN | Secure Web Authentication (SWA) | | BASIC_AUTH | HTTP Basic Authentication with Okta Browser Plugin | | BOOKMARK | Just a bookmark (no-authentication) | | BROWSER_PLUGIN | Secure Web Authentication (SWA) with Okta Browser Plugin | | OPENID_CONNECT | Federated Authentication with OpenID Connect (OIDC) | | SAML_1_1 | Federated Authentication with SAML 1.1 WebSSO (not supported for custom apps) | | SAML_2_0 | Federated Authentication with SAML 2.0 WebSSO | | SECURE_PASSWORD_STORE | Secure Web Authentication (SWA) with POST (plugin not required) | | WS_FEDERATION | Federated Authentication with WS-Federation Passive Requestor Profile | Select the signOnMode for your custom app: |
status | string | No | — | App instance status |
universalLogout | object | No | — | <div class=“x-lifecycle-container”><x-lifecycle class=“oie”></x-lifecycle></div> Universal Logout properties for the app. These properties are only returned and can’t be updated. |
visibility | object | No | — | Specifies visibility settings for the app |
okta-apps_deactivate_application
Deactivate an application Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | — | Application ID |
okta-apps_delete_application
Delete an application Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | — | Application ID |
okta-apps_get_application
Retrieve an application Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | — | Application ID |
expand | string | No | — | An optional query parameter to return the specified Application User in the _embedded property. Valid value: expand=user/{userId} |
okta-apps_get_application_group_assignment
Retrieve an application group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | — | Application ID |
groupId | string | Yes | — | The id of the group |
expand | string | No | — | An optional query parameter to return the corresponding assigned group or the group assignment metadata details in the _embedded property. |
okta-apps_get_application_user
Retrieve an application user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | — | Application ID |
userId | string | Yes | — | ID of an existing Okta user |
expand | string | No | — | An optional query parameter to return the corresponding User object in the _embedded property. Valid value: user |
okta-apps_list_application_group_assignments
List all application groups Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | — | Application ID |
q | string | No | — | Specifies a filter for a list of assigned groups returned based on their names. The value of q is matched against the group name. This filter only supports the startsWith operation that matches the q string against the beginning of the group name. |
after | string | No | — | Specifies the pagination cursor for the next page of results. Treat this as an opaque value obtained through the next link relationship. See Pagination. |
limit | integer | No | — | Specifies the number of objects to return per page. If there are multiple pages of results, the Link header contains a next link that you need to use as an opaque value (follow it, don’t parse it). See Pagination. |
expand | string | No | — | An optional query parameter to return the corresponding assigned group or the group assignment metadata details in the _embedded property. |
okta-apps_list_application_users
List all application users Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | — | Application ID |
after | string | No | — | Specifies the pagination cursor for the next page of results. Treat this as an opaque value obtained through the next link relationship. See Pagination. |
limit | integer | No | — | Specifies the number of objects to return per page. If there are multiple pages of results, the Link header contains a next link that you need to use as an opaque value (follow it, don’t parse it). See Pagination. |
q | string | No | — | Specifies a filter for the list of application users returned based on their profile attributes. The value of q is matched against the beginning of the following profile attributes: userName, firstName, lastName, and email. This filter only supports the startsWith operation that matches the q string against the beginning of the attribute values. > Note: For OIDC apps, user profiles don’t contain the firstName or lastName attributes. Therefore, the query only matches against the userName or email attributes. |
expand | string | No | — | An optional query parameter to return the corresponding User object in the _embedded property. Valid value: user |
okta-apps_list_applications
List all applications Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q | string | No | — | Searches for apps with name or label properties that starts with the q value using the startsWith operation |
after | string | No | — | Specifies the pagination cursor for the next page of results. Treat this as an opaque value obtained through the next link relationship. |
useOptimization | boolean | No | — | Specifies whether to use query optimization. If you specify useOptimization=true in the request query, the response contains a subset of app instance properties. |
alwaysIncludeVpnSettings | boolean | No | — | Specifies whether to include the VPN configuration for existing notifications in the result, regardless of whether VPN notifications are configured |
limit | integer | No | — | Specifies the number of results per page |
filter | string | No | — | Filters apps with a supported expression for a subset of properties. Filtering supports the following limited number of properties: id, status, credentials.signing.kid, settings.slo.enabled, or name. See Filter. |
expand | string | No | — | An optional parameter used for link expansion to embed more resources in the response. Only supports expand=user/{userId} and must be used with the user.id eq "{userId}" filter query for the same user. Returns the assigned application user in the _embedded property. |
includeNonDeleted | boolean | No | — | Specifies whether to include non-active, but not deleted apps in the results |
okta-apps_replace_application
Replace an application Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | — | Application ID |
_embedded | object | No | — | Embedded resources related to the app using the JSON Hypertext Application Language specification. If the expand=user/{userId} query parameter is specified, then the assigned Application User is embedded. |
_links | object | No | — | Discoverable resources related to the app |
accessibility | object | No | — | Specifies access settings for the app |
created | string | No | — | Timestamp when the application object was created |
expressConfiguration | object | No | — | <div class=“x-lifecycle-container”><x-lifecycle class=“oie”></x-lifecycle></div> Indicates which Express Configuration capabilities the app supports and has enabled |
features | string[] | No | — | Enabled app features > Note: See Application Features for app provisioning features. |
id | string | No | — | Unique ID for the app instance |
label | string | Yes | — | User-defined display name for app |
lastUpdated | string | No | — | Timestamp when the application object was last updated |
licensing | object | No | — | Licenses for the app |
orn | string | No | — | The Okta resource name (ORN) for the current app instance |
profile | object | No | — | Contains any valid JSON schema for specifying properties that can be referenced from a request (only available to OAuth 2.0 client apps). For example, add an app manager contact email address or define an allowlist of groups that you can then reference using the Okta Expression Language getFilteredGroups function. > Notes: > * profile isn’t encrypted, so don’t store sensitive data in it. > * profile doesn’t limit the level of nesting in the JSON schema you created, but there is a practical size limit. Okta recommends a JSON schema size of 1 MB or less for best performance. |
signOnMode | string | Yes | — | Authentication mode for the app | signOnMode | Description | | ---------- | ----------- | | AUTO_LOGIN | Secure Web Authentication (SWA) | | BASIC_AUTH | HTTP Basic Authentication with Okta Browser Plugin | | BOOKMARK | Just a bookmark (no-authentication) | | BROWSER_PLUGIN | Secure Web Authentication (SWA) with Okta Browser Plugin | | OPENID_CONNECT | Federated Authentication with OpenID Connect (OIDC) | | SAML_1_1 | Federated Authentication with SAML 1.1 WebSSO (not supported for custom apps) | | SAML_2_0 | Federated Authentication with SAML 2.0 WebSSO | | SECURE_PASSWORD_STORE | Secure Web Authentication (SWA) with POST (plugin not required) | | WS_FEDERATION | Federated Authentication with WS-Federation Passive Requestor Profile | Select the signOnMode for your custom app: |
status | string | No | — | App instance status |
universalLogout | object | No | — | <div class=“x-lifecycle-container”><x-lifecycle class=“oie”></x-lifecycle></div> Universal Logout properties for the app. These properties are only returned and can’t be updated. |
visibility | object | No | — | Specifies visibility settings for the app |
okta-apps_unassign_application_from_group
Unassign an application group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | — | Application ID |
groupId | string | Yes | — | The id of the group |
okta-apps_unassign_user_from_application
Unassign an application user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | — | Application ID |
userId | string | Yes | — | ID of an existing Okta user |
sendEmail | boolean | No | — | Sends a deactivation email to the administrator if true |
okta-apps_update_application_user
Update an application user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | — | Application ID |
userId | string | Yes | — | ID of an existing Okta user |
body | object | Yes | — | Request body |
okta-apps_update_group_assignment_to_application
Update an application group Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | — | Application ID |
groupId | string | Yes | — | The id of the group |
body | object[] | No | — | Request body |

