Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Tenable Role API

Groupment of permissions that may be assigned to several users

Tenable Role API is one of 107 APIs that Tenable publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Role. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 8 operations across 5 paths. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against a single base URL, https://www.tenable.com/downloads/api/v2.

8 operations 5 paths 0 schemas 1 DELETE3 GET1 PATCH2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://cloud.tenable.com
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Tenable Role API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Bearer). By default, every request must be authenticated.

  • Bearer — Example: Bearer {{token}}

Paths & Operations 8

Across 5 paths, the API surfaces 8 operations — 1 DELETE, 3 GET, 1 PATCH, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Role 8

Groupment of permissions that may be assigned to several users

GET
/api/roles
Retrieve all role instances.
1 param → 200401500
POST
/api/roles
Create role instance.
1 param body → 201401500
GET
/api/roles/user-creation-defaults
Return the default roles for user creation
1 param → 200401500
GET
/api/roles/{id}
Get role instance by id.
2 params → 200401500
PATCH
/api/roles/{id}
Update role instance.
2 params body → 200401500
DELETE
/api/roles/{id}
Delete role instance.
2 params → 204401500
POST
/api/roles/from/{fromId}
Creates a new role from another one
2 params body → 204401500
PUT
/api/roles/{id}/permissions
Replace permission list for a role
2 params body → 200401500

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tenable-role-api-openapi.yml Raw ↑

Other APIs Tenable publishes across the network.

Tenable About API
Tenable Access Control (API) API
Tenable Access Control (Groups) API
Tenable Access Control (Permissions) API
Tenable Access Control (Roles) API
Tenable Access Control (Users) API
Tenable Access Groups v1 API
Tenable Access Groups v2 API
Tenable Account Groups API
Tenable Accounts API
Tenable Activity Log API
Tenable AD object API