{
  "opencollection": "1.0.0",
  "info": {
    "name": "Downloads About OT Connectors API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "Authorization",
      "value": "{{Authorization}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "OT Connectors",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Create OT connector",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://www.tenable.com/downloads/api/v2/sensors",
            "headers": [
              {
                "name": "x-linking-key",
                "value": ""
              },
              {
                "name": "x-target-site",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates an OT connector. \n\nThe response includes a token when you create the OT connector. The token is the only credential that is used for authentication when the OT connector connects to Tenable Vulnerability Management.\n\n**Note:** You can generate the required linking key and retrieve the target site with the [Create linking key](ref:sensors-ot-linking-key-generate) endpoint."
        },
        {
          "info": {
            "name": "List OT connectors",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/sensors/:type",
            "params": [
              {
                "name": "type",
                "value": "",
                "type": "path",
                "description": "The type of connector or sensor. This value is always `ot` for OT connectors."
              },
              {
                "name": "sortBy",
                "value": "",
                "type": "query",
                "description": "The attribute used to sort the list of OT connectors."
              },
              {
                "name": "orderBy",
                "value": "",
                "type": "query",
                "description": "The criteria used to order the list of OT connectors. If this value is omitted, Tenable uses the default value `asc`."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "The maximum number of OT connectors to return. The valid range is [1-200]."
              },
              {
                "name": "exclusiveStartKey",
                "value": "",
                "type": "query",
                "description": "The ID of the last OT connector included in the current result set. This parameter is used for paging through the results and it must be used in conjunction with the `exclusiveStartSortKey` parameter."
              },
              {
                "name": "exclusiveStartSortKey",
                "value": "",
                "type": "query",
                "description": "The value of the `sortBy` key for which to sort the returned list of OT connectors. It must be used in conjunction with the `exclusiveStartKey` parameter."
              }
            ]
          },
          "docs": "Returns a list of Tenable OT connectors. <div class=\"perms-callout\">Requires the Scan Manager [40] user role or the `VM.VM_SENSOR.VM_SCANNER.READ` custom role privilege. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Get OT connector details",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/sensors/:type/:id",
            "params": [
              {
                "name": "type",
                "value": "",
                "type": "path",
                "description": "The type of connector or sensor. This value is always `ot` for OT connectors."
              },
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The OT connector's unique identifier."
              }
            ]
          },
          "docs": "Returns details for the specified OT connector. <div class=\"perms-callout\">Requires the Scan Manager [40] user role or the `VM.VM_SENSOR.VM_SCANNER.READ` custom role privilege. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Update OT connector",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://www.tenable.com/downloads/api/v2/sensors/:type/:id",
            "params": [
              {
                "name": "type",
                "value": "",
                "type": "path",
                "description": "The type of connector or sensor. This value is always `ot` for OT connectors."
              },
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The OT connector's unique identifier."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Updates the specified OT connector. This endpoint can also be used to enable or disable an OT connector. <div class=\"perms-callout\">Requires the Scan Manager [40] user role or the `VM.VM_SENSOR.VM_SCANNER.EDIT` custom role privilege. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Delete OT connector",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://www.tenable.com/downloads/api/v2/sensors/:type/:id",
            "params": [
              {
                "name": "type",
                "value": "",
                "type": "path",
                "description": "The type of connector or sensor. This value is always `ot` for OT connectors."
              },
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The OT connector's unique identifier."
              }
            ]
          },
          "docs": "Deletes an OT connector. <div class=\"perms-callout\">Requires the Scan Manager [40] user role or the `VM.VM_SENSOR.VM_SCANNER.DELETE` custom role privilege. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Generate linking key",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://www.tenable.com/downloads/api/v2/sensors/:type/linking-key",
            "params": [
              {
                "name": "type",
                "value": "",
                "type": "path",
                "description": "The type of connector or sensor. This value is always `ot` for OT connectors."
              }
            ]
          },
          "docs": "Generates a single-use linking key that is valid for two hours. Additionally, the target site for your account is retrieved (ex. `us-2b`). \n\nThe linking key and target site are required when creating an OT connector with the [Create OT connector](ref:sensors-ot-create) endpoint.\n\nOnce linked, an OT connector can transmit assets and findings data from Tenable OT Security to Tenable Vulnerability Management. <div class=\"perms-callout\">Requires the Administrator [64] user role. See [Roles](doc:role"
        }
      ]
    }
  ],
  "bundled": true
}