---
title: Cohesity
slug: connectors/cohesity
docTags: 
createdAt: 2026-06-09T16:30:31.162Z
---

Cohesity is a data management platform that consolidates and manages data across various environments, enhancing data protection and accessibility.

Cohesity is a leading data management platform that simplifies data protection and management across hybrid and multi-cloud environments. The Cohesity connector for Swimlane Turbine enables users to seamlessly integrate Cohesity's robust data protection capabilities into their security automation workflows. By leveraging this integration, users can efficiently retrieve protection summaries and node lists from Cohesity clusters, enhancing their ability to monitor and manage data protection activities. This integration empowers security teams to automate data protection tasks, ensuring comprehensive coverage and streamlined operations within the Swimlane Turbine platform.

The Connector integrates Cohesity's REST API with Swimlane turbine.

## Prerequisites

Before you can use the Cohesity connector for Turbine, you'll need access to the Cohesity API. This requires the following:

- an API key authentication using the following parameters:
  - URL: The endpoint URL for accessing the Cohesity API.
  - API Key: A unique key provided by Cohesity to authenticate API requests.

## Capabilities

This Connector provides the following capabilities:

- Get Protection Summary
- List Nodes

## Notes

- [API Doc](https://developer.cohesity.com/docs/helios-getting-started)

## Additional Documentation

- [Cohesity Connector Documentation](https://docs.swimlane.com/connectors/cohesity)
- [Cohesity API Documentation](https://developer.cohesity.com/docs/helios-getting-started)

# Configurations

## Cohesity API Key Authentication

Authenticates using an API Key

### Configuration Parameters

| **Parameter** | **Description**                    | **Type** | **Required** |
| ------------- | ---------------------------------- | -------- | ------------ |
| url           | A URL to the target host.          | string   | Required     |
| apiKey        | API key                            | string   | Required     |
| verify\_ssl   | Verify SSL certificate             | boolean  | Optional     |
| http\_proxy   | A proxy to route requests through. | string   | Optional     |

# Actions

## Get Protection Summary

Compute and retrieve the protection summary of clusters in Cohesity.

### Endpoint

- **URL:** `/irisservices/api/v1/public/mcm/stats/protectionSummary`
- **Method:** `GET`

### Output

| **Parameter**           | **Type** | **Description**                     |
| ----------------------- | -------- | ----------------------------------- |
| `status_code`           | number   | HTTP status code of the response    |
| `reason`                | string   | Response reason phrase              |
| `numObjectsProtected`   | number   | Output field: numObjectsProtected   |
| `numObjectsUnprotected` | number   | Output field: numObjectsUnprotected |
| `statsByEnv`            | array    | Output field: statsByEnv            |
| `statsByEnv.file_name`  | string   | Name of the resource                |
| `statsByEnv.file`       | string   | Output field: statsByEnv.file       |
| `protectedSizeBytes`    | number   | Output field: protectedSizeBytes    |
| `unprotectedSizeBytes`  | number   | Output field: unprotectedSizeBytes  |

### Output Example

`{"status_code":200,"response_headers":{"Date":"Mon, 05 Feb 2024 09:24:20 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"close","x-frame-options":"SAMEORIGIN","x-prisma-event-id":"91244f24-846b-f0fa-9e3c-f079bb160e5f","content-encoding":"gzip","vary":"Accept-Encoding","content-security-policy":"frame-ancestors 'self';","x-xss-protection":"1; mode=block","x-content-type-options":"nosniff","referrer-policy":"strict-origin-when-cross-origin","x-download-options":"...`

## List Nodes

Retrieve a list of nodes within the Cohesity cluster.

### Endpoint

- **URL:** `/irisservices/api/v1/public/nodes`
- **Method:** `GET`

### Input

| **Argument Name**         | **Type** | **Required** | **Description**              |
| ------------------------- | -------- | ------------ | ---------------------------- |
| `headers`                 | object   | Optional     | HTTP headers for the request |
| `headers.accessClusterId` | string   | Optional     | HTTP headers for the request |

### Input Example

`{"headers":{"accessClusterId":"askd2234"}}`

### Output

| **Parameter** | **Type** | **Description**                  |
| ------------- | -------- | -------------------------------- |
| `status_code` | number   | HTTP status code of the response |
| `reason`      | string   | Response reason phrase           |

### Output Example

`{"status_code":200,"response_headers":{"Date":"Mon, 05 Feb 2024 09:23:55 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"close","x-frame-options":"SAMEORIGIN","x-prisma-event-id":"580f3388-f1bb-d6bd-15e8-b8ddcf7dba55","content-encoding":"gzip","vary":"Accept-Encoding","content-security-policy":"frame-ancestors 'self';","x-xss-protection":"1; mode=block","x-content-type-options":"nosniff","referrer-policy":"strict-origin-when-cross-origin","x-download-options":"...`

# Response Headers

| **Header**                | **Description**                                       | **Example**                                                                                          |
| ------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Connection                | HTTP response header: Connection                      | close                                                                                                |
| content-encoding          | HTTP response header: content-encoding                | gzip                                                                                                 |
| content-security-policy   | HTTP response header: content-security-policy         | frame-ancestors 'self';                                                                              |
| Content-Type              | The media type of the resource                        | application/json                                                                                     |
| Date                      | The date and time at which the message was originated | Mon, 05 Feb 2024 09:24:20 GMT                                                                        |
| feature-policy            | HTTP response header: feature-policy                  | camera 'none';microphone 'none';geolocation 'none';encrypted-media 'none';payment 'none';usb 'none'; |
| referrer-policy           | HTTP response header: referrer-policy                 | strict-origin-when-cross-origin                                                                      |
| strict-transport-security | HTTP response header: strict-transport-security       | max-age=31536000; includeSubDomains                                                                  |
| Transfer-Encoding         | HTTP response header: Transfer-Encoding               | chunked                                                                                              |
| vary                      | HTTP response header: vary                            | Accept-Encoding                                                                                      |
| x-content-type-options    | HTTP response header: x-content-type-options          | nosniff                                                                                              |
| x-dns-prefetch-control    | HTTP response header: x-dns-prefetch-control          | off                                                                                                  |
| x-download-options        | HTTP response header: x-download-options              | noopen                                                                                               |
| x-frame-options           | HTTP response header: x-frame-options                 | SAMEORIGIN                                                                                           |
| x-prisma-event-id         | HTTP response header: x-prisma-event-id               | 580f3388-f1bb-d6bd-15e8-b8ddcf7dba55                                                                 |
| x-xss-protection          | HTTP response header: x-xss-protection                | 1; mode=block                                                                                        |
