# Cohesity Principals API

**Canonical:** https://apis.io/apis/cohesity/cohesity-principals-api/  
**Provider:** Cohesity — https://apis.io/providers/cohesity/  
**Base URL:** https://helios.cohesity.com/irisservices/api/v1/public/  
**Documentation:** https://developer.cohesity.com/helios-api.html

Cohesity Principals API is one of 91 APIs that [Cohesity](https://apis.io/providers/cohesity/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Principals. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and an API reference.

The Principals API from Cohesity — 10 operation(s) for principals.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| GET | `/public/principals/protectionSources` | Returns the Protection Sources objects and View names that the principals have… |
| PUT | `/public/principals/protectionSources` | Set the Protection Sources and Views that the specified principal has… |
| GET | `/public/principals/searchPrincipals` | List the user and group principals that match the filter criteria specified… |
| GET | `/public/sessionUser` | Get the information of the logged in user |
| GET | `/public/users` | List the users on the Cohesity Cluster that match the filter criteria specified… |
| PUT | `/public/users` | Update an existing user on the Cohesity Cluster. |
| POST | `/public/users` | Create or add a new user to the Cohesity Cluster |
| DELETE | `/public/users` | Delete one or more users on the Cohesity Cluster |
| GET | `/public/users/privileges` | List the privileges of the session user |
| POST | `/public/users/s3SecretKey` | Reset the S3 secret access key for the specified user on the Cohesity Cluster |
| GET | `/public/users/{sid}/apiKeys` | Fetch API keys for user |
| POST | `/public/users/{sid}/apiKeys` | Create an API key for user |
| GET | `/public/users/{sid}/apiKeys/{id}` | Fetch an API key for user by its id |
| PUT | `/public/users/{sid}/apiKeys/{id}` | Update an API key |
| DELETE | `/public/users/{sid}/apiKeys/{id}` | Delete an API key for user |
| POST | `/public/users/{sid}/apiKeys/{id}/rotate` | Fetch an API key for user by its id |
| GET | `/public/usersApiKeys` | Fetch API keys across all users |

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cohesity/refs/heads/main/openapi/cohesity-principals-api-openapi.yml
- **Documentation** — https://developer.cohesity.com/helios-api.html
- **GettingStarted** — https://developer.cohesity.com/docs/helios-getting-started
- **APIReference** — https://developer.cohesity.com/apidocs/versions/
- **Postman** — https://api.cohesity.com/
- **Documentation** — https://developer.cohesity.com/apidocs/versions/
- **APIReference** — https://developers.cohesity.com/page/api-reference
- **GettingStarted** — https://developers.cohesity.com/docs/getting-started
- **Documentation** — https://developer.cohesity.com/apidocs/helios-reporting
- **Documentation** — https://developer.cohesity.com/apidocs/site-continuity

## Other Cohesity APIs (12)

- [Cohesity Alerts API](https://apis.io/apis/cohesity/cohesity-alerts-api/)
- [Cohesity Analytics API](https://apis.io/apis/cohesity/cohesity-analytics-api/)
- [Cohesity Antivirus Service Group API](https://apis.io/apis/cohesity/cohesity-antivirusservicegroup-api/)
- [Cohesity App API](https://apis.io/apis/cohesity/cohesity-app-api/)
- [Cohesity App Instance API](https://apis.io/apis/cohesity/cohesity-appinstance-api/)
- [Cohesity Applications API](https://apis.io/apis/cohesity/cohesity-applications-api/)
- [Cohesity Artifacts API](https://apis.io/apis/cohesity/cohesity-artifacts-api/)
- [Cohesity Audit API](https://apis.io/apis/cohesity/cohesity-audit-api/)
- [Cohesity Banner API](https://apis.io/apis/cohesity/cohesity-banner-api/)
- [Cohesity Certificates API](https://apis.io/apis/cohesity/cohesity-certificates-api/)
- [Cohesity Clone Refresh Tasks API](https://apis.io/apis/cohesity/cohesity-clonerefreshtasks-api/)
- [Cohesity Cluster API](https://apis.io/apis/cohesity/cohesity-cluster-api/)

## Tags

Principals

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cohesity/cohesity-principals-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cohesity/.