Cohesity

Cohesity Certificates API

The Certificates API from Cohesity — 2 operation(s) for certificates.

GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /public/certificates/global List host certificates generated by the cluster · List the certificates generated and deployed on hosts #
Ask an LLM
“Which certificates has the cluster generated and deployed to hosts?”
“Can I see the details of all host certificates issued from this cluster?”
Tell an agent
List the host certificates generated by the cluster.
Show all deployed global host certificates.
POST /public/certificates/global Generate and deploy host certificates · Generate and deploy certificate for a single or multiple hosts #
Ask an LLM
“Can I generate a certificate and push it to one or more hosts?”
“How long can a generated host certificate stay valid?”
Tell an agent
Generate and deploy a certificate to hosts {hostsInfoList}.
Deploy a host certificate valid for {validDays} days to {hostsInfoList}.
GET /public/certificates/webServer Get the cluster web server certificate · Get the Server Certificate configured on the Cluster #
Ask an LLM
“Which SSL certificate is the cluster's web server using right now?”
“When was the web server certificate last updated?”
Tell an agent
Show the cluster web server certificate.
Get the SSL certificate configured for the cluster UI.
PUT /public/certificates/webServer Replace the cluster web server certificate · Update the Web Server Certificate on the Cluster #
Ask an LLM
“How do I install my own SSL certificate on the cluster web server?”
“What does replacing the web server certificate need, a cert and private key?”
Tell an agent
Install web server certificate {certificate} with private key {privateKey}.
Replace the cluster SSL certificate with {certificate}.
DELETE /public/certificates/webServer Delete the cluster web server certificate · Delete the SSL Certificate in the Cluster #
Ask an LLM
“Can I remove the custom SSL certificate from the cluster?”
“What happens to the web server certificate if I delete it?”
Tell an agent destructive · confirm first
Delete the cluster web server certificate.
Remove the custom SSL certificate from the cluster.

Documentation

📖
Documentation
https://developer.cohesity.com/helios-api.html
📖
GettingStarted
https://developer.cohesity.com/docs/helios-getting-started
📖
APIReference
https://developer.cohesity.com/apidocs/versions/
📖
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

Specifications

⚙
OpenAPI
https://artifacts.apis.io/cohesity/openapi/cohesity-certificates-api-openapi.yml

Other Resources

🔗
Postman
https://api.cohesity.com/

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/cohesity:cohesity-certificates-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.

GitHub Google LinkedIn

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

OpenAPI Specification

cohesity-certificates-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: 'This API list provides operations for interfacing with the Cohesity

    Cluster.'
  title: Cohesity REST Certificates API
  version: '1.0'
servers:
- url: https://<CLUSTER_VIP>/irisservices/api/v1
tags:
- name: Certificates
paths:
  /public/certificates/global:
    get:
      description: Returns the all certificate and their details generated from this cluster.
      tags:
      - Certificates
      summary: List the certificates generated and deployed on hosts
      operationId: GetCertificateList
      responses:
        '200':
          $ref: '#/components/responses/GetCertificateResponse'
        default:
          $ref: '#/components/responses/Error'
    post:
      description: Returns the global certificate for a single or multiple hosts.
      tags:
      - Certificates
      summary: Generate and deploy certificate for a single or multiple hosts
      operationId: DeployHostCertificate
      responses:
        '201':
          $ref: '#/components/responses/DeployHostCertResponse'
        default:
          $ref: '#/components/responses/Error'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeployCertParameters'
        description: Request to generate and deploy a new certificate.
  /public/certificates/webServer:
    get:
      description: Returns the Server Certificate configured on the cluster.
      tags:
      - Certificates
      summary: Get the Server Certificate configured on the Cluster
      operationId: GetWebServerCertificate
      responses:
        '200':
          $ref: '#/components/responses/GetWebServerCertificateResponse'
        default:
          $ref: '#/components/responses/Error'
    put:
      description: Returns the updated Web Server Certificate on the cluster.
      tags:
      - Certificates
      summary: Update the Web Server Certificate on the Cluster
      operationId: UpdateWebServerCertificate
      responses:
        '200':
          $ref: '#/components/responses/UpdateWebServerCertificateResponse'
        default:
          $ref: '#/components/responses/Error'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SslCertificateConfig'
    delete:
      description: Returns delete status upon completion.
      tags:
      - Certificates
      summary: Delete the SSL Certificate in the Cluster
      operationId: DeleteWebServerCertificate
      responses:
        '204':
          $ref: '#/components/responses/NoContentResponse'
        default:
          $ref: '#/components/responses/Error'
components:
  schemas:
    SslCertificateConfig:
      description: 'SslCertificateConfig represents the SSL certificate object exposed to the

        user.'
      type: object
      title: SSL Certificate Configuration.
      properties:
        certificate:
          description: Certificate is a SSL certificate used by Iris HTTPS webserver.
          type:
          - string
          - 'null'
          x-go-name: Certificate
        lastUpdateTimeMsecs:
          description: 'LastUpdateTimeMsecs is a time in milliseconds at which certificate was

            last updated.'
          type:
          - integer
          - 'null'
          format: int64
          x-go-name: LastUpdateTimeMsecs
        privateKey:
          description: PrivateKey is a matching private key of the above certificate.
          type:
          - string
          - 'null'
          x-go-name: PrivateKey
      x-go-package: cohesity/iris/server/data/public
    HostInfo:
      description: Specifies the list of all hosts on which the certificate is deployed.
      type: object
      title: Hosts Information list.
      properties:
        password:
          description: 'Specifies the password of the host to establish SSH connection.

            The certificate is copied to the host after generating the certificate

            on the cluster.'
          type:
          - string
          - 'null'
          x-go-name: Password
        serverName:
          description: Specifies the servername of the host where certificate is to be deployed.
          type:
          - string
          - 'null'
          x-go-name: ServerName
        target:
          description: 'Specifies the target location on the host where the certificate is

            deployed.'
          type:
          - string
          - 'null'
          x-go-name: Target
        userName:
          description: Specifies the username of the host.
          type:
          - string
          - 'null'
          x-go-name: UserName
      x-go-package: cohesity/iris/server/data/public
    RequestError:
      description: Details about the Error.
      type: object
      title: Error
      properties:
        errorCode:
          description: Operation response error code.
          type:
          - integer
          - 'null'
          format: int64
          x-go-name: ErrorCode
        message:
          description: Description of the error.
          type:
          - string
          - 'null'
          x-go-name: Message
      x-go-package: cohesity/iris/server/data/public
    DeployCertParameters:
      description: Specifies the parameters used to generate and deploy a certificate.
      type: object
      title: Deploy host global certificate Request.
      properties:
        certFileName:
          description: Specifies the filename of the certificate.
          type:
          - string
          - 'null'
          x-go-name: CertFileName
        hostsInfoList:
          description: 'Specifies the list of all hosts on which the certificate is to

            be deployed.'
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/HostInfo'
          x-go-name: HostsInfoList
        type:
          description: 'Specifies the type of the host such as ''kSapHana'', ''kSapOracle'', etc.

            Specifies the host type of host for generating and deploying a

            Certificate.

            ''kOther'' indicates it is any of the other hosts.

            ''kSapOracle'' indicates it is a SAP Oracle host.

            ''kSapHana'' indicates it is a SAP HANA host.'
          type:
          - string
          - 'null'
          enum:
          - kOther
          - kSapOracle
          - kSapHana
          x-go-name: Type
        validDays:
          description: 'Specifies the number of days after which the certificate will expire. The

            user has to input the number of days (from the current date) till when the

            certificate is valid.'
          type:
          - integer
          - 'null'
          format: int64
          x-go-name: ValidDays
      x-go-package: cohesity/iris/server/data/public
    CertificateDetails:
      description: Specifies details about a certificate.
      type: object
      title: Certificate Details.
      properties:
        certFileName:
          description: 'Specifies the filename of the certificate. This is unique to each

            certificate generated.'
          type:
          - string
          - 'null'
          x-go-name: CertFileName
        expiryDate:
          description: Specifies the date in epoch till when the certificate is valid.
          type:
          - string
          - 'null'
          x-go-name: ExpiryDate
        hostIps:
          description: 'Each certificate can be deployed to multiple hosts. List of all hosts

            is returned after deployment.'
          type:
          - array
          - 'null'
          items:
            type: string
          x-go-name: HostIps
        type:
          description: 'Specifies the type of the host such as ''kSapHana'', ''kSapOracle'', etc.

            Specifies the host type of host for generating and deploying a

            Certificate.

            ''kOther'' indicates it is any of the other hosts.

            ''kSapOracle'' indicates it is a SAP Oracle host.

            ''kSapHana'' indicates it is a SAP HANA host.'
          type:
          - string
          - 'null'
          enum:
          - kOther
          - kSapOracle
          - kSapHana
          x-go-name: Type
      x-go-package: cohesity/iris/server/data/public
    ListCertResponse:
      description: Specifies list of all certificates deployed from the cluster.
      type: object
      title: List Certificates Response
      properties:
        certificateList:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/CertificateDetails'
          x-go-name: CertificateList
      x-go-package: cohesity/iris/server/data/public
  responses:
    GetCertificateResponse:
      description: List Host Certificate Response.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ListCertResponse'
    Error:
      description: Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RequestError'
    DeployHostCertResponse:
      description: Host Certificate Download Response.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CertificateDetails'
    GetWebServerCertificateResponse:
      description: Success
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SslCertificateConfig'
    NoContentResponse:
      description: No Content
    UpdateWebServerCertificateResponse:
      description: Success
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SslCertificateConfig'