Tenable Email notifier API
An email notification about new deviances
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/tenable-email-notifier-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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Identity Exposure Email notifier API
description: API to interact with Identity Exposure.
version: production
servers:
- url: '{protocol}://customer.tenable.ad'
variables:
protocol:
default: https
tags:
- name: Email notifier
description: An email notification about new deviances
paths:
/api/email-notifiers:
get:
summary: Retrieve all email-notifier instances
description: 'Required license type: ioa, ioaPreview, ioe'
responses:
'200':
description: ''
content:
application/json:
schema:
description: Validates the get /email-notifiers response
type: array
items:
description: email-notifier
type: object
additionalProperties: false
required:
- id
- address
- criticityThreshold
- directories
- checkers
- attackTypes
- profiles
- shouldNotifyOnInitialFullSecurityCheck
- description
- inputType
properties:
id:
type: integer
address:
type: string
criticityThreshold:
type: integer
directories:
minItems: 1
type: array
items:
type: integer
description:
type:
- string
- 'null'
checkers:
type:
- array
- 'null'
minItems: 1
items:
type: integer
attackTypes:
type:
- array
- 'null'
minItems: 1
items:
type: integer
profiles:
type:
- array
- 'null'
minItems: 1
items:
type: integer
shouldNotifyOnInitialFullSecurityCheck:
type: boolean
inputType:
enum:
- deviances
- attacks
- healthChecks
healthCheckNames:
type:
- array
- 'null'
minItems: 1
items:
type: string
'401':
description: Unauthorized
'500':
description: Internal server error
tags:
- Email notifier
x-tenablead-required-product-license-type:
- ioa
- ioaPreview
- ioe
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: []
operationId: getApiEmailNotifiers
x-operation-id-source: derived
post:
summary: Create email-notifier instance
description: 'Required license type: ioa, ioaPreview, ioe'
responses:
'201':
description: ''
content:
application/json:
schema:
description: Validates the post /email-notifiers response
type: array
items:
description: email-notifier
type: object
additionalProperties: false
required:
- id
- address
- criticityThreshold
- directories
- checkers
- attackTypes
- profiles
- shouldNotifyOnInitialFullSecurityCheck
- description
- inputType
properties:
id:
type: integer
address:
type: string
criticityThreshold:
type: integer
directories:
minItems: 1
type: array
items:
type: integer
description:
type:
- string
- 'null'
checkers:
type:
- array
- 'null'
minItems: 1
items:
type: integer
attackTypes:
type:
- array
- 'null'
minItems: 1
items:
type: integer
profiles:
type:
- array
- 'null'
minItems: 1
items:
type: integer
shouldNotifyOnInitialFullSecurityCheck:
type: boolean
inputType:
enum:
- deviances
- attacks
- healthChecks
healthCheckNames:
type:
- array
- 'null'
minItems: 1
items:
type: string
'401':
description: Unauthorized
'500':
description: Internal server error
tags:
- Email notifier
x-tenablead-required-product-license-type:
- ioa
- ioaPreview
- ioe
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:
description: Validates the post /email-notifiers response
type: array
minItems: 1
items:
allOf:
- type: object
required:
- address
- criticityThreshold
- directories
- shouldNotifyOnInitialFullSecurityCheck
- inputType
properties:
address:
type: string
criticityThreshold:
type: integer
directories:
minItems: 1
type: array
items:
type: integer
description:
type: string
shouldNotifyOnInitialFullSecurityCheck:
type: boolean
inputType:
type: string
enum:
- deviances
- attacks
- healthChecks
- description: List the properties that depend on the input type
type: object
oneOf:
- allOf:
- properties:
inputType:
enum:
- deviances
- required:
- checkers
- profiles
properties:
checkers:
type: array
minItems: 1
items:
type: integer
profiles:
type: array
minItems: 1
items:
type: integer
- allOf:
- not:
properties:
inputType:
enum:
- deviances
- oneOf:
- allOf:
- properties:
inputType:
enum:
- attacks
- required:
- attackTypes
- profiles
properties:
attackTypes:
type: array
minItems: 1
items:
type: integer
profiles:
type: array
minItems: 1
items:
type: integer
- allOf:
- not:
properties:
inputType:
enum:
- attacks
- {}
operationId: postApiEmailNotifiers
x-operation-id-source: derived
/api/email-notifiers/{id}:
get:
summary: Get email-notifier instance by id
description: 'Required license type: ioa, ioaPreview, ioe'
responses:
'200':
description: ''
content:
application/json:
schema:
description: email-notifier
type: object
additionalProperties: false
required:
- id
- address
- criticityThreshold
- directories
- checkers
- attackTypes
- profiles
- shouldNotifyOnInitialFullSecurityCheck
- description
- inputType
properties:
id:
type: integer
address:
type: string
criticityThreshold:
type: integer
directories:
minItems: 1
type: array
items:
type: integer
description:
type:
- string
- 'null'
checkers:
type:
- array
- 'null'
minItems: 1
items:
type: integer
attackTypes:
type:
- array
- 'null'
minItems: 1
items:
type: integer
profiles:
type:
- array
- 'null'
minItems: 1
items:
type: integer
shouldNotifyOnInitialFullSecurityCheck:
type: boolean
inputType:
enum:
- deviances
- attacks
- healthChecks
healthCheckNames:
type:
- array
- 'null'
minItems: 1
items:
type: string
'401':
description: Unauthorized
'500':
description: Internal server error
tags:
- Email notifier
x-tenablead-required-product-license-type:
- ioa
- ioaPreview
- ioe
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: id
in: path
schema:
type: string
pattern: ^[0-9]+$
x-patternError: should be a numerical string
required: true
deprecated: false
security:
- ApiKey: []
operationId: getApiEmailNotifiersById
x-operation-id-source: derived
patch:
summary: Update email-notifier instance
description: 'Required license type: ioa, ioaPreview, ioe'
responses:
'200':
description: ''
content:
application/json:
schema:
description: email-notifier
type: object
additionalProperties: false
required:
- id
- address
- criticityThreshold
- directories
- checkers
- attackTypes
- profiles
- shouldNotifyOnInitialFullSecurityCheck
- description
- inputType
properties:
id:
type: integer
address:
type: string
criticityThreshold:
type: integer
directories:
minItems: 1
type: array
items:
type: integer
description:
type:
- string
- 'null'
checkers:
type:
- array
- 'null'
minItems: 1
items:
type: integer
attackTypes:
type:
- array
- 'null'
minItems: 1
items:
type: integer
profiles:
type:
- array
- 'null'
minItems: 1
items:
type: integer
shouldNotifyOnInitialFullSecurityCheck:
type: boolean
inputType:
enum:
- deviances
- attacks
- healthChecks
healthCheckNames:
type:
- array
- 'null'
minItems: 1
items:
type: string
'401':
description: Unauthorized
'500':
description: Internal server error
tags:
- Email notifier
x-tenablead-required-product-license-type:
- ioa
- ioaPreview
- ioe
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: id
in: path
schema:
type: string
pattern: ^[0-9]+$
x-patternError: should be a numerical string
required: true
deprecated: false
security:
- ApiKey: []
requestBody:
required: true
content:
application/json:
schema:
description: Validates the post /email-notifiers response
type: object
properties:
address:
type: string
criticityThreshold:
type: integer
directories:
minItems: 1
type: array
items:
type: integer
description:
type: string
checkers:
type:
- array
- 'null'
minItems: 1
items:
type: integer
attackTypes:
type:
- array
- 'null'
minItems: 1
items:
type: integer
profiles:
type:
- array
- 'null'
minItems: 1
items:
type: integer
inputType:
enum:
- deviances
- attacks
- healthChecks
operationId: patchApiEmailNotifiersById
x-operation-id-source: derived
delete:
summary: Delete email-notifier instance
description: 'Required license type: ioa, ioaPreview, ioe'
responses:
'204':
description: ''
content:
application/json:
schema:
description: email-notifier
additionalProperties: false
'401':
description: Unauthorized
'500':
description: Internal server error
tags:
- Email notifier
x-tenablead-required-product-license-type:
- ioa
- ioaPreview
- ioe
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: id
in: path
schema:
type: string
pattern: ^[0-9]+$
x-patternError: should be a numerical string
required: true
deprecated: false
security:
- ApiKey: []
operationId: deleteApiEmailNotifiersById
x-operation-id-source: derived
/api/email-notifiers/test-message/{id}:
get:
summary: Send a test email notification by id
description: 'Required license type: ioa, ioaPreview, ioe'
responses:
'200':
description: ''
content:
application/json:
schema:
description: Validates the post /email-notifiers/ response
'401':
description: Unauthorized
'500':
description: Internal server error
tags:
- Email notifier
x-tenablead-required-product-license-type:
- ioa
- ioaPreview
- ioe
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: id
in: path
schema:
type: string
pattern: ^[0-9]+$
x-patternError: should be a numerical string
required: true
deprecated: false
security:
- ApiKey: []
operationId: getApiEmailNotifiersTestMessageById
x-operation-id-source: derived
/api/email-notifiers/test-message:
post:
summary: Send a test email notification
description: 'Required license type: ioa, ioaPreview, ioe'
responses:
'200':
description: ''
content:
application/json:
schema:
description: Validates the post /email-notifier/ response
'401':
description: Unauthorized
'500':
description: Internal server error
tags:
- Email notifier
x-tenablead-required-product-license-type:
- ioa
- ioaPreview
- ioe
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:
description: Validates the post /email-notifiers/test-message payload
allOf:
- type: object
required:
- address
- criticityThreshold
- directories
- inputType
properties:
address:
type: string
criticityThreshold:
type: integer
directories:
type: array
items:
type: integer
description:
type: string
inputType:
type: string
enum:
- deviances
- attacks
- healthChecks
- description: List the properties that depend on the input type
type: object
oneOf:
- allOf:
- properties:
inputType:
enum:
- deviances
- required:
- checkers
- profiles
properties:
checkers:
type: array
minItems: 1
items:
type: integer
profiles:
type: array
minItems: 1
items:
type: integer
- allOf:
- not:
properties:
inputType:
enum:
- deviances
- oneOf:
- allOf:
- properties:
inputType:
enum:
- attacks
- required:
- attackTypes
- profiles
properties:
attackTypes:
type: array
minItems: 1
items:
type: integer
profiles:
type: array
minItems: 1
items:
type: integer
- allOf:
- not:
properties:
inputType:
enum:
- attacks
- {}
operationId: postApiEmailNotifiersTestMessage
x-operation-id-source: derived
components:
securitySchemes:
ApiKey:
name: x-api-key
description: The user's API key
in: header
type: apiKey
x-readme:
explorer-enabled: true
proxy-enabled: true