Sudo mode

Sudo mode allows users to perform privileged actions after going through a re-authentication flow.

Sudo mode is an elevated security state in which a user will be re-authenticated to alllow them to temporarily perform privileged actions via the API such as the creation of Automation tokens. It does not upgrade or otherwise change the role of the user. The user can only perform these actions until the sudo expiry time is reached.

Error states

The following error states may be returned from requesting sudo access.

A response with a JSON body containing an error code is returned on error.

StatusCodeDescription
403forbiddenThe supplied username/password combination is not correct.

Data model

expiry_timestringA UTC time-stamp of when sudo access will expire. If blank, sudo access expires five minutes after the request.

Endpoints

Request Sudo access

POST/sudo