Tenable Event API

A change in the Active Directory

Operations 3

GET /api/directories/{directoryId}/events/{id} Get event instance by id.
GET /api/infrastructures/{infrastructureId}/directories/{directoryId}/events/{id} Get event instance by id.
POST /api/events/search Search events instances

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/tenable-event-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

tenable-event-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: 1.0.0
  title: Downloads About Event API
  description: 'The Downloads API enables customers to access and download installation and update files for available Tenable products. You can use the API endpoints to list product pages, list downloads available for a specific product, and to download a file. The endpoints can also be used to determine and download the latest version of a file to facilitate the automation of an installation.


    **Note:** The Tenable Downloads API uses a different server URL than the Tenable Vulnerability Management API:


    `https://www.tenable.com/downloads/api/v2/pages`.


    ### Authentication


    Like the Downloads website, certain files require authentication to download. When files have a `"requires_auth": true` attribute on the product list page, the Downloads API uses bearer token authentication and requires a valid token in the Authorization header to download the file:

    ```

    Authorization: Bearer AbCdEf123456

    ```


    To access or reset your authentication token, navigate to the [Authentication Token](https://www.tenable.com/downloads/api-docs) page.


    Examples of product downloads that **do not** require authentication include Nessus and Nessus Agents.'
servers:
- url: https://www.tenable.com/downloads/api/v2
security:
- Bearer: []
tags:
- name: Event
  description: A change in the Active Directory
paths:
  /api/directories/{directoryId}/events/{id}:
    get:
      summary: Get event instance by id.
      description: 'Required license type: ioe, ioaPreview, ioa'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                description: An event instance
                type: object
                additionalProperties: false
                required:
                - id
                - adObjectId
                - directoryId
                - date
                - type
                properties:
                  id:
                    format: int64
                  adObjectId:
                    type: number
                  directoryId:
                    type: number
                  type:
                    type:
                    - string
                    - 'null'
                  date:
                    type: string
                    format: date-time
        '401':
          description: Unauthorized
        '500':
          description: Internal server error
      tags:
      - Event
      x-tenablead-required-product-license-type:
      - ioe
      - ioaPreview
      - ioa
      parameters:
      - name: x-api-key
        description: The user's API key
        in: header
        schema:
          type: string
          default: put-your-api-key-here
        required: true
        deprecated: false
      - name: directoryId
        in: path
        schema:
          type: string
          pattern: ^[0-9]+$
          x-patternError: should be a numerical string
        required: true
        deprecated: false
      - name: id
        in: path
        schema:
          type: string
          pattern: ^[0-9]+$
          x-patternError: should be a numerical string
        required: true
        deprecated: false
      security:
      - ApiKey: []
  /api/infrastructures/{infrastructureId}/directories/{directoryId}/events/{id}:
    get:
      summary: Get event instance by id.
      description: 'Required license type: ioe, ioaPreview, ioa'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                description: An event instance
                type: object
                additionalProperties: false
                required:
                - id
                - adObjectId
                - directoryId
                - date
                - type
                properties:
                  id:
                    format: int64
                  adObjectId:
                    type: number
                  directoryId:
                    type: number
                  type:
                    type:
                    - string
                    - 'null'
                  date:
                    type: string
                    format: date-time
        '401':
          description: Unauthorized
        '500':
          description: Internal server error
      tags:
      - Event
      x-tenablead-required-product-license-type:
      - ioe
      - ioaPreview
      - ioa
      parameters:
      - name: x-api-key
        description: The user's API key
        in: header
        schema:
          type: string
          default: put-your-api-key-here
        required: true
        deprecated: false
      - name: infrastructureId
        in: path
        schema:
          type: string
          pattern: ^[0-9]+$
          x-patternError: should be a numerical string
        required: true
        deprecated: false
      - name: directoryId
        in: path
        schema:
          type: string
          pattern: ^[0-9]+$
          x-patternError: should be a numerical string
        required: true
        deprecated: false
      - name: id
        in: path
        schema:
          type: string
          pattern: ^[0-9]+$
          x-patternError: should be a numerical string
        required: true
        deprecated: false
      security:
      - ApiKey: []
  /api/events/search:
    post:
      summary: Search events instances
      description: 'Required license type: ioe, ioaPreview, ioa'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                description: Validates the POST /infrastructures/{infraId}/directories/{dirId}/events response
                type: array
                items:
                  description: An event instance
                  type: object
                  additionalProperties: false
                  required:
                  - id
                  - adObjectId
                  - directoryId
                  - date
                  - type
                  properties:
                    id:
                      format: int64
                    adObjectId:
                      type: number
                    directoryId:
                      type: number
                    type:
                      type:
                      - string
                      - 'null'
                    date:
                      type: string
                      format: date-time
        '401':
          description: Unauthorized
        '500':
          description: Internal server error
      tags:
      - Event
      x-tenablead-required-product-license-type:
      - ioe
      - ioaPreview
      - ioa
      parameters:
      - name: x-api-key
        description: The user's API key
        in: header
        schema:
          type: string
          default: put-your-api-key-here
        required: true
        deprecated: false
      security:
      - ApiKey: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - expression
              - profileId
              - directoryIds
              - dateStart
              - dateEnd
              properties:
                expression:
                  type: object
                order:
                  type: object
                  properties:
                    column:
                      type: string
                      enum:
                      - id
                    direction:
                      type: string
                      enum:
                      - asc
                      - desc
                profileId:
                  type: integer
                directoryIds:
                  type: array
                  minItems: 1
                  items:
                    type: integer
                dateStart:
                  type: string
                  format: date-time
                dateEnd:
                  type: string
                  format: date-time
components:
  securitySchemes:
    Bearer:
      type: apiKey
      in: header
      name: Authorization
      description: 'Example: Bearer {{token}}'
x-readme:
  proxy-enabled: false
  explorer-enabled: true
  samples-enabled: true
  samples-languages:
  - python
  - curl
  - node
  - powershell
  - ruby
  - javascript
  - objectivec
  - java
  - php
  - csharp
  - go
  - swift
  - kotlin