Create and start an activity session
POST/api/v1/ActivitySession
Creates an activity session for the target resource or credential and queues it to start. If the access policy requires approval, the session waits for approval before it is scheduled. The session is created for the signed-in user, and application accounts must name the user in managedAccountId.
Permission required: Any signed-in user with a managed account, or an application account.
Values for customFields[].customFieldDataType: 0 = Integer, 1 = String, 2 = Options.
Request
Responses
- 201
- 400
- 401
- 404
The session was created and queued. The body is the new activity session, and the Location header points to it.
The request is not valid. The body is the message, for example that the account is locked, that the resource, credential or activity could not be found, that no resource or credential was supplied, that no access policy grants the user this activity, or that a note or ticket the policy requires is missing.
The request is not signed in, or the sign-in has expired.
The account for the session was not found.