Skip to navigation

Update software access app

View as Markdown

Changes the fields you send and returns the full updated document.

Send only the fields you want to change, plus version with the num from your last read and a change_description. This is a JSON merge-patch: a field you leave out keeps its stored value, and every list or map you send replaces the stored one whole. The id goes in the URL; if you also send id in the body it must match.

Authentication

AuthorizationBearer

JWT bearer token authentication. Include the Configuration API key in the Authorization header as ‘Bearer <token>’.

Path parameters

idstringRequired

The id of the software access app, as returned when it was created or listed.

Request

This endpoint expects an object.
versionobjectRequired
Document version. On update, send back the num from your last read.
in_assistant_enabledbooleanOptional

If true, users can request this app through the AI Assistant. Takes precedence over access_rule_dsl; use the access rule for more granular control.

access_rule_dslstringOptional
DSL rule deciding which users can request this app. Use 'true' to allow all users, 'false' to allow none, or a DSL expression.
admins_email_addrslist of stringsOptional

Email addresses of the app admins who can approve access. Required when the approval model includes app admin approval (APP_ADMIN, APP_ADMIN_THEN_MANAGER, or AUTO_APPROVE_FULL_TIME_ELSE_APP_ADMIN).

role_based_provisioningobjectOptional

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_provisioningobjectOptional

Group-based provisioning: membership in a single group grants access. Set exactly one provisioning strategy.

self_service_provisioningobjectOptional

Self-service provisioning: no automated provisioning; the user is shown instructions to get the app themselves. Set exactly one provisioning strategy.

Response

The updated software access app, at its new version
idstringOptionalRead-only
Unique identifier of the app, assigned by the server.
namestringOptionalformat: "^[^/]+$"1-128 characters
Name of the app as users ask for it. Must be unique in the org and cannot be changed after creation.
in_assistant_enabledbooleanOptional

If true, users can request this app through the AI Assistant. Takes precedence over access_rule_dsl; use the access rule for more granular control.

access_rule_dslstringOptional
DSL rule deciding which users can request this app. Use 'true' to allow all users, 'false' to allow none, or a DSL expression.
admins_email_addrslist of stringsOptional

Email addresses of the app admins who can approve access. Required when the approval model includes app admin approval (APP_ADMIN, APP_ADMIN_THEN_MANAGER, or AUTO_APPROVE_FULL_TIME_ELSE_APP_ADMIN).

role_based_provisioningobjectOptional

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_provisioningobjectOptional

Group-based provisioning: membership in a single group grants access. Set exactly one provisioning strategy.

self_service_provisioningobjectOptional

Self-service provisioning: no automated provisioning; the user is shown instructions to get the app themselves. Set exactly one provisioning strategy.

updated_timedatetimeOptionalRead-only
When the configuration was last updated.
updated_bystringOptionalRead-only
Who last updated the configuration.
versionobjectOptional
Document version. On update, send back the num from your last read.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error