ThousandEyes Integrations API
Manage connectors and operations.
Manage connectors and operations.
openapi: 3.0.1
security:
- BearerAuth: []
info:
title: Integrations API
description: '**Note:** The Webhook Operations APIs are not available for ThousandEyes for Government instance.
Manage connectors and operations.
'
version: 7.0.100
x-provenance:
method: harvested
authored_by: Cisco ThousandEyes
harvested_by: API Evangelist
harvested_on: '2026-08-19'
first_party: true
provider_published: true
source_host: pubhub.devnetcloud.com
note: 27 OpenAPI 3.0 documents (26 per-area plus a unified 326-operation document) served anonymously from Cisco's DevNet
CDN. api.thousandeyes.com itself 401s every path, so the contract is public while the API host is gated.
x-evidence:
- type: source
url: https://pubhub.devnetcloud.com/media/000-v7-apis/docs/reference/
- type: source
url: https://developer.cisco.com/docs/thousandeyes/
servers:
- url: https://api.thousandeyes.com/v7
description: ThousandEyes API v7
tags:
- name: Credential Vault Operations
description: Credential Vault operations allow you to configure vault secrets.
- name: Operation Connectors
description: Manage the connectors assigned to an operation.
- name: CyberArk Conjur Connectors
description: The CyberArk Conjur instance you want the ThousandEyes platform to integrate with.
- name: Webhook Operations
description: Webhook operations allow you to customize the payload of generic connectors.
- name: Generic Connectors
description: A generic connector represents an instance of a third-party service that you can integrate with the ThousandEyes
platform.
- name: Panorama Connectors
description: A Panorama connector represents an instance of Palo Alto Networks Panorama that you can integrate with the
ThousandEyes platform.
paths:
/operations/{type}/{id}/connectors:
get:
tags:
- Operation Connectors
summary: Retrieve connectors assigned to an operation
description: Returns a list of connectors assigned to a specific operation.
operationId: getOperationConnectors
parameters:
- name: type
in: path
description: The operation type.
required: true
schema:
type: string
example: webhooks
- $ref: '#/components/parameters/operationIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
responses:
'200':
description: A list of assigned connectors.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Assignments'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
put:
tags:
- Operation Connectors
summary: Assign connectors to an operation
description: 'Assigns one or more connectors to an operation. This replaces any existing assignments. Note: This operation
may disable affected objects (such as tests) if connectors are changed.'
operationId: setOperationConnectors
parameters:
- name: type
in: path
description: The operation type.
required: true
schema:
type: string
example: webhooks
- $ref: '#/components/parameters/operationIdPath'
name: id
in: path
required: true
schema:
type: string
- name: confirmDisabledObjects
in: query
description: Confirmation to disable affected objects (for example, tests) for credential-vault operations.
required: false
schema:
type: boolean
default: false
example: true
- $ref: '#/components/parameters/AccountGroupId'
requestBody:
description: List of connector IDs to assign to the operation.
content:
application/json:
schema:
maxItems: 1
minItems: 0
type: array
items:
type: string
example:
- ca39314d-eb4f-496f-9435-b5d20b1bfbff
required: true
responses:
'200':
description: Operation Connectors updated successfully.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Assignments'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
/operations/webhooks/{id}:
get:
tags:
- Webhook Operations
summary: Retrieve webhook operation
description: Retrieves details of a webhook operation by its ID.
operationId: getWebhookOperation
parameters:
- $ref: '#/components/parameters/operationIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
responses:
'200':
description: Webhook operation with the given id.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/WebhookOperation'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
put:
tags:
- Webhook Operations
summary: Update webhook operation
description: Updates the webhook operation specified by ID.
operationId: updateWebhookOperation
parameters:
- $ref: '#/components/parameters/operationIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/WebhookOperation'
required: true
responses:
'200':
description: The updated webhook operation.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/WebhookOperation'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
delete:
tags:
- Webhook Operations
summary: Delete webhook operation
description: Deletes the webhook operation specified by ID.
operationId: deleteWebhookOperation
parameters:
- $ref: '#/components/parameters/operationIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
responses:
'204':
description: No Content.
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
/operations/credential-vault/{id}:
get:
tags:
- Credential Vault Operations
summary: Get Credential Vault operation
description: Retrieve a single Credential Vault operation by its ID.
operationId: getCredentialVaultOperation
parameters:
- $ref: '#/components/parameters/operationIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
responses:
'200':
description: Credential Vault operation details.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/CredentialVaultOperation'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
put:
tags:
- Credential Vault Operations
summary: Update Credential Vault operation
description: Update a single existing Credential Vault operation.
operationId: updateCredentialVaultOperation
parameters:
- $ref: '#/components/parameters/operationIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CredentialVaultOperation'
required: true
responses:
'200':
description: The updated Credential Vault operation.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/CredentialVaultOperation'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
delete:
tags:
- Credential Vault Operations
summary: Delete Credential Vault operation
description: 'Delete a single Credential Vault operation by its ID. Note: This operation may disable affected objects
(such as tests).'
operationId: deleteCredentialVaultOperation
parameters:
- $ref: '#/components/parameters/operationIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
- name: confirmDisabledObjects
in: query
description: Confirmation to disable affected objects (for example, tests) for credential-vault operations.
required: true
schema:
type: boolean
default: false
example: true
responses:
'204':
description: No Content.
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
/connectors/generic/{id}:
get:
tags:
- Generic Connectors
summary: Retrieve connector
description: Retrieves details of a connector by its ID.
operationId: getGenericConnector
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
responses:
'200':
description: Connector details.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/GenericConnector'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
put:
tags:
- Generic Connectors
summary: Update connector
description: Updates the connector specified by ID.
operationId: updateGenericConnector
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GenericConnector'
required: true
responses:
'200':
description: The updated connector.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/GenericConnector'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
delete:
tags:
- Generic Connectors
summary: Delete connector
description: Deletes the connector specified by ID.
operationId: deleteGenericConnector
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
responses:
'204':
description: No Content.
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
/connectors/panorama/{id}:
get:
tags:
- Panorama Connectors
summary: Retrieve Panorama connector
description: Retrieves details of a Panorama connector by its ID.
operationId: getPanoramaConnector
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
responses:
'200':
description: Panorama connector details.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/PanoramaConnector'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
put:
tags:
- Panorama Connectors
summary: Update Panorama connector
description: Replaces the Panorama connector specified by ID. The request must include the complete connector configuration,
including authentication credentials; existing credentials are not retained when authentication is omitted.
operationId: updatePanoramaConnector
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PanoramaConnector'
example:
type: panorama
name: Branch Panorama
target: https://panorama.example.com
authentication:
username: panorama-user
password: <panorama-password>
keyTtl: 40
type: pan-key-gen
required: true
responses:
'200':
description: The updated Panorama connector.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/PanoramaConnector'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
delete:
tags:
- Panorama Connectors
summary: Delete Panorama connector
description: Deletes the Panorama connector specified by ID.
operationId: deletePanoramaConnector
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
responses:
'204':
description: No Content.
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
/connectors/panorama/{id}/operations:
get:
tags:
- Panorama Connectors
summary: List operation IDs for Panorama connector
description: Returns a list of operation IDs assigned to a Panorama connector.
operationId: getPanoramaConnectorOperations
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
responses:
'200':
description: Operation IDs assigned to the Panorama connector.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Assignments'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
put:
tags:
- Panorama Connectors
summary: Assign operations to Panorama connector
description: Assigns operations to a Panorama connector. This replaces any existing assignments. Passing an empty array
removes all operation assignments from the connector.
operationId: setPanoramaConnectorOperations
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
requestBody:
description: List of operation IDs to assign to the connector.
content:
application/json:
schema:
type: array
items:
type: string
example:
- ca39314d-eb4f-496f-9435-b5d20b1bfbff
- a32cfbab-32f6-41d8-9027-7127cba965dd
required: true
responses:
'200':
description: Operations assigned successfully.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Assignments'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
/connectors/generic/{id}/operations:
get:
tags:
- Generic Connectors
summary: List operation IDs for a connector
description: Returns a list of operation IDs assigned to a connector.
operationId: listGenericConnectorOperations
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
responses:
'200':
description: A list of assigned operation IDs.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Assignments'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
put:
tags:
- Generic Connectors
summary: Assign operations to a connector
description: Assigns operations to a connector. This replaces any existing assignments.
operationId: setGenericConnectorOperations
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
requestBody:
description: List of operation IDs to assign to the connector.
content:
application/json:
schema:
type: array
items:
type: string
example:
- ca39314d-eb4f-496f-9435-b5d20b1bfbff
- a32cfbab-32f6-41d8-9027-7127cba965dd
required: true
responses:
'200':
description: Operations assigned successfully.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Assignments'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
/connectors/conjur/{id}:
get:
tags:
- CyberArk Conjur Connectors
summary: Retrieve a Conjur connector
description: Retrieves details of a CyberArk Conjur connector by its ID.
operationId: getConjurConnector
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
responses:
'200':
description: CyberArk Conjur Connector details.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/ConjurConnector'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
put:
tags:
- CyberArk Conjur Connectors
summary: Update a Conjur connector
description: Updates the CyberArk Conjur connector specified by ID.
operationId: updateConjurConnector
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ConjurConnector'
required: true
responses:
'200':
description: The updated connector.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/ConjurConnector'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
delete:
tags:
- CyberArk Conjur Connectors
summary: Delete a Conjur connector
description: 'Deleted the CyberArk Conjur connector specified by ID. Note: This operation may disable affected objects
(such as tests).'
operationId: deleteConjurConnector
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
- name: confirmDisabledObjects
in: query
description: Confirmation to disable affected objects (for example, tests) for Conjur connectors.
required: true
schema:
type: boolean
default: false
example: true
responses:
'204':
description: No Content.
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
/connectors/conjur/{id}/operations:
get:
tags:
- CyberArk Conjur Connectors
summary: List operation IDs for a Conjur connector
description: Returns a list of operation IDs assigned to a CyberArk Conjur connector.
operationId: getConjurConnectorOperations
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/AccountGroupId'
responses:
'200':
description: A list of assigned operation IDs.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Assignments'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
put:
tags:
- CyberArk Conjur Connectors
summary: Assign operations to a Conjur connector
description: 'Assigns operations to a CyberArk Conjur connector. This replaces any existing assignments. Note: This
operation may disable affected objects (such as tests) if operations are changed.'
operationId: setConjurConnectorOperations
parameters:
- $ref: '#/components/parameters/connectorIdPath'
name: id
in: path
required: true
schema:
type: string
- name: confirmDisabledObjects
in: query
description: Confirmation to disable affected objects (for example, tests) for Conjur connectors.
required: true
schema:
type: boolean
default: false
example: true
- $ref: '#/components/parameters/AccountGroupId'
requestBody:
description: List of operation IDs to assign to the connector.
content:
application/json:
schema:
type: array
items:
type: string
example:
- ca39314d-eb4f-496f-9435-b5d20b1bfbff
- a32cfbab-32f6-41d8-9027-7127cba965dd
required: true
responses:
'200':
description: Operations assigned successfully.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Assignments'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
/operations/webhooks:
get:
tags:
- Webhook Operations
summary: List webhook operations
description: Returns a list of webhook operations in the specified account group. If no account group is specified,
the user’s default account group is used.
operationId: getWebhookOperations
parameters:
- $ref: '#/components/parameters/AccountGroupId'
responses:
'200':
description: A list of webhook operations.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/WebhookOperations'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
post:
tags:
- Webhook Operations
summary: Create webhook operation
description: Creates a new webhook operation.
operationId: createWebhookOperation
parameters:
- $ref: '#/components/parameters/AccountGroupId'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/WebhookOperation'
required: true
responses:
'201':
description: The created webhook operation.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/WebhookOperation'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
/operations/credential-vault:
get:
tags:
- Credential Vault Operations
summary: List Credential Vault operations
description: Returns a list of Credential Vault operations in the specified account group. If no account group is specified,
the user's default account group is used.
operationId: getCredentialVaultOperations
parameters:
- $ref: '#/components/parameters/AccountGroupId'
responses:
'200':
description: A list of Credential Vault operations.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/CredentialVaultOperations'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
post:
tags:
- Credential Vault Operations
summary: Create Credential Vault operation
description: Create a new Credential Vault operation.
operationId: createCredentialVaultOperation
parameters:
- $ref: '#/components/parameters/AccountGroupId'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CredentialVaultOperation'
required: true
responses:
'201':
description: The created Credential Vault operation.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/CredentialVaultOperation'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'500':
$ref: '#/components/responses/500'
/connectors/generic:
get:
tags:
- Generic Connectors
summary: List connectors
description: Returns a list of connectors in the specified account group. If no account group is specified, the user’s
default account group is used.
operationId: getGenericConnectors
parameters:
- $ref: '#/components/parameters/AccountGroupId'
responses:
'200':
description: A list of connectors.
content:
application/hal+json:
schema:
$ref: '#/components/schemas/GenericConnectors'
# --- truncated at 32 KB (56 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/thousandeyes/refs/heads/main/openapi/thousandeyes-integrations-openapi.yml