The swagger.yaml file documents all available iManage Threat Manager API endpoints and their parameters. When rendered in a Swagger-compatible viewer, you can view, navigate, and interact with the file, including trying out requests with custom parameters and viewing responses.

Task: View the Threat Manager API documentation

Two viewing options are available.

Option 1: Local editor

Open swagger.yaml in a Swagger-compatible editor or plug-in. Visual Studio Code (https://code.visualstudio.com/download) is a free, open-source option that supports Swagger rendering via plug-ins.

Option 2: Online viewer

A free online Swagger viewer and editor is available at https://editor.swagger.io/. To view the file, paste or drag it in.

(On-premises) The https://editor.swagger.io/ viewer is only compatible with iManage Threat Manager instances that have HTTPS enabled. If your instance of iManage Threat Manager is configured for HTTP, for example in an on-premises test environment, attempts to authenticate with /v2/login/api_token from https://editor.swagger.io/ won’t succeed. In this case, use a Swagger-compatible plug-in as mentioned above.