Software Access Apps
tool.access-software.apps
The software catalog. approval_key.custom_key must name an EXISTING named approval workflow. Supported provisioner systems: ACTIVE_DIRECTORY, GSUITE, MS_GRAPH, OKTA, ONELOGIN.
- Endpoint:
/tool/access-software/apps| Methods: GET, PATCH, POST - Request shape: fields go at the top level of the JSON body, with no
resourcewrapper. The item’sidgoes in the URL for reads and updates, not in the body. - Updates: a JSON merge-patch. Send only the fields you change, plus
version: {num, change_description}with thenumfrom your last read. Lists and maps you send replace the stored ones whole.
Endpoints
All paths are relative to https://api.moveworks.ai/configurations/v1alpha1. Each endpoint page lists the request and response schema, an example, and the errors it can return.
Fields
Set at most one of role_based_provisioning, group_based_provisioning, self_service_provisioning.
Variants (3, pick one)
role_based_provisioning
Role-based provisioning: the user picks one of two or more roles (licenses, environments, versions) provisioned through your identity system. Set exactly one provisioning strategy.
group_based_provisioning
Group-based provisioning: membership in a single group grants access. Set exactly one provisioning strategy.
self_service_provisioning
Self-service provisioning: no automated provisioning; the user is shown instructions to get the app themselves. Set exactly one provisioning strategy.