Update an activity
PUT/api/v1/Activity/:id
Replaces the settings of an existing activity with the activity in the request body. Changes to the name, platform, sign-in account and similar settings are recorded in the event log.
Permission required: Administrator role. The signed-in session must have completed multifactor authentication.
Values for activityType: 0 = Interactive, 1 = InteractiveAppLaunch, 2 = TaskAutomation, 3 = CredentialRelease, 4 = FileRelease.
Values for loginAccount: 0 = Requester, 1 = Managed, 2 = ActivityIdentity (shown as Activity Token in the console), 3 = Vault, 4 = Resource.
Values for requesterLoginFormat: 0 = Samaccountname (Domain\SamAccountName), 1 = UPN (User Principal Name), 2 = Email, 3 = SamAccountNameOnly (SamAccountName), 4 = Custom.
Caution: The change replaces the stored activity and takes effect immediately, so send the full activity rather than only the fields you want to change.
Request
Responses
- 200
- 400
- 404
- 500
The activity is updated. The response body is the updated activity.
The id in the path does not match the id in the body, or the sign-in account name template is missing or invalid. The response body is a message as plain text.
No activity exists with this id.
The update failed, for example because another activity already has the same name or the name is missing.