Skip to main content

Create an activity

POST 

/api/v1/Activity

Creates an activity. If you do not supply the start, during and end step groups, the server creates an empty group for each and returns their ids. The creation is 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 activity is created immediately and can start applying wherever it is later added to an access policy.

Request​

Responses​

The activity is created. The response body is the new activity, and the Location header points to it.