{
  "opencollection": "1.0.0",
  "info": {
    "name": "Downloads About Access Control (Roles) API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "Authorization",
      "value": "{{Authorization}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Access Control (Roles)",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List roles",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/access-control/v1/roles"
          },
          "docs": "Lists all roles defined for your Tenable Vulnerability Management instance, including both standard and custom roles.<div class=\"perms-callout\">Requires the Administrator [64] user role or the `TIO_BACKEND.ACCESS_CONTROL.READ` custom role privilege. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Create role",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://www.tenable.com/downloads/api/v2/access-control/v1/roles",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a custom role with the specified permissions.<div class=\"perms-callout\">Requires the Administrator [64] user role or the `TIO_BACKEND.ACCESS_CONTROL.MANAGE` custom role privilege. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Get role details",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/access-control/v1/roles/:role_uuid",
            "params": [
              {
                "name": "role_uuid",
                "value": "",
                "type": "path",
                "description": "Specifies the unique identifier (UUID) of the role."
              }
            ]
          },
          "docs": "Retrieves the details for the specified role.<div class=\"perms-callout\">Requires the Administrator [64] user role or the `TIO_BACKEND.ACCESS_CONTROL.READ` custom role privilege. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Update role",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://www.tenable.com/downloads/api/v2/access-control/v1/roles/:role_uuid",
            "params": [
              {
                "name": "role_uuid",
                "value": "",
                "type": "path",
                "description": "Specifies the unique identifier (UUID) of the role."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Updates the specified custom role.<div class=\"perms-callout\">Requires the Administrator [64] user role or the `TIO_BACKEND.ACCESS_CONTROL.MANAGE` custom role privilege. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Delete role",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://www.tenable.com/downloads/api/v2/access-control/v1/roles/:role_uuid",
            "params": [
              {
                "name": "role_uuid",
                "value": "",
                "type": "path",
                "description": "Specifies the unique identifier (UUID) of the role."
              }
            ]
          },
          "docs": "Deletes the specified custom role.<div class=\"perms-callout\">Requires the Administrator [64] user role or the `TIO_BACKEND.ACCESS_CONTROL.MANAGE` custom role privilege. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List role permissions",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/access-control/v1/role-permissions"
          },
          "docs": "Lists all available role permission strings (custom role privileges) and their metadata, including hierarchical relationships between permissions. Use this endpoint to determine valid values for the `role_permission_strings` property when creating or updating a custom role.\n\n**Note:** Role permission strings are the same as the custom role privileges referenced throughout the Tenable documentation and in the permissions callouts for individual API endpoints.<div class=\"perms-callout\">Requires th"
        }
      ]
    }
  ],
  "bundled": true
}