Cohesity

Cohesity Tenants API

The Tenants API from Cohesity — 3 operation(s) for tenants.

GitHub OpenAPI

Operations 4

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 /tenants/swift Get a tenant's Swift configuration · Get a Swift configuration #
Ask an LLM
“What Swift object storage settings does a tenant have?”
“Which Keystone configuration is a tenant's Swift tied to?”
Tell an agent
Get the Swift configuration for tenant {tenantId}.
Show the Swift configuration.
PUT /tenants/swift Update a tenant's Swift configuration · Update a Swift configuration #
Ask an LLM
“Can I change which Keystone a tenant's Swift service uses?”
“How do I set which roles may operate on Swift for a tenant?”
Tell an agent
Update Swift for tenant {tenantId} to use Keystone {keystoneId}.
Set Swift operator roles for tenant {tenantId} to {operatorRoles}.
POST /tenants/swift/register Register a tenant's Swift service with Keystone · Register Swift service on a Keystone server #
Ask an LLM
“How do I register Swift for a tenant on a Keystone server?”
“What credentials are needed to register Swift with Keystone?”
Tell an agent
Register Swift for tenant {tenantId} on Keystone.
Register tenant {tenantId}'s Swift service using Keystone credentials {keystoneCredentials}.
POST /tenants/swift/unregister Unregister a tenant's Swift service from Keystone · Unregister Swift service from a Keystone server #
Ask an LLM
“How do I remove a tenant's Swift service from Keystone?”
“Can I unregister Swift for one tenant only?”
Tell an agent destructive · confirm first
Unregister Swift for tenant {tenantId} from Keystone.
Remove tenant {tenantId}'s Swift registration using credentials {keystoneCredentials}.

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-tenants-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-tenants-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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-tenants-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: Cohesity API provides a RESTful interface to access the various data management operations on Cohesity cluster and Helios.
  title: Cohesity REST Tenants API
  version: '2.0'
servers:
- url: /v2
tags:
- name: Tenants
paths:
  /tenants/swift:
    get:
      description: Get a Swift configuration.
      tags:
      - Tenants
      summary: Get a Swift configuration
      operationId: GetTenantSwift
      parameters:
      - description: Specifies the tenant Id.
        name: tenantId
        in: query
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/GetSwiftResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - APIKeyHeader: []
    put:
      description: Update a Swift configuration.
      tags:
      - Tenants
      summary: Update a Swift configuration
      operationId: UpdateTenantSwift
      responses:
        '200':
          $ref: '#/components/responses/UpdateSwiftResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - APIKeyHeader: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SwiftParams'
        description: Specifies the parameters to update a Swift configuration.
        required: true
  /tenants/swift/register:
    post:
      description: Register Swift service on Keystone server.
      tags:
      - Tenants
      summary: Register Swift service on a Keystone server
      operationId: RegisterSwift
      responses:
        '204':
          $ref: '#/components/responses/NoContentResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - APIKeyHeader: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterSwiftParams'
        description: Specifies the parameters to register a Swift service on Keystone server.
        required: true
  /tenants/swift/unregister:
    post:
      description: Unregister Swift service from Keystone server.
      tags:
      - Tenants
      summary: Unregister Swift service from a Keystone server
      operationId: UnregisterSwift
      responses:
        '204':
          $ref: '#/components/responses/NoContentResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
      security:
      - APIKeyHeader: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UnregisterSwiftParams'
        description: Specifies the parameters to unregister a Swift service from Keystone server.
        required: true
components:
  schemas:
    KeystoneScopeParams:
      description: Specifies scope paramteres of a Keystone.
      type: object
      required:
      - type
      properties:
        type:
          description: Specifies the scope type.
          type:
          - string
          - 'null'
          enum:
          - Project
          - Domain
          x-order: 0
        projectScopeParams:
          description: Specifies the parameter for project type scope.
          type: object
          allOf:
          - $ref: '#/components/schemas/ProjectScopeParams'
          - {}
          x-order: 1
        domainScopeParams:
          description: Specifies the parameters for domain type scope.
          type: object
          allOf:
          - $ref: '#/components/schemas/DomainScopeParams'
          - {}
          x-order: 2
    Error:
      description: Specifies the error object with error code and a message.
      type: object
      title: Error.
      properties:
        errorCode:
          description: Specifies the error code.
          type:
          - string
          - 'null'
          x-order: 0
        message:
          description: Specifies the error message.
          type:
          - string
          - 'null'
          x-order: 1
    UnregisterSwiftParams:
      description: Specifies the parameters to unregister a Swift service from Keystone server.
      type: object
      required:
      - tenantId
      properties:
        tenantId:
          description: Specifies the tenant Id who's Swift service will be unregistered.
          type:
          - string
          - 'null'
          x-order: 0
        keystoneCredentials:
          description: Specifies the credentials of the Keystone server. Keystone configuration associated to the tenant will be used if this field is not specified.
          type:
          - object
          - 'null'
          x-order: 1
          $ref: '#/components/schemas/KeystoneCredentials'
    SwiftParams:
      description: Specifies the parameters to update a Swift configuration.
      type: object
      required:
      - tenantId
      properties:
        tenantId:
          description: Specifies the tenant Id who will use this Swift configuration.
          type:
          - string
          - 'null'
          x-order: 0
        keystoneId:
          description: Specifies the associated Keystone configuration Id.
          type:
          - integer
          - 'null'
          format: int64
          x-order: 1
        operatorRoles:
          description: Specifies a list of roles that can operate on Cohesity Swift service.
          type: array
          minItems: 1
          uniqueItems: true
          items:
            type: string
          x-order: 2
    RegisterSwiftParams:
      description: Specifies the parameters to register a Swift service on Keystone server.
      type: object
      required:
      - tenantId
      properties:
        tenantId:
          description: Specifies the tenant Id who's Swift service will be registered.
          type:
          - string
          - 'null'
          x-order: 0
        keystoneCredentials:
          description: Specifies the credentials of the Keystone server. Keystone configuration associated to the tenant will be used if this field is not specified.
          type:
          - object
          - 'null'
          x-order: 1
          $ref: '#/components/schemas/KeystoneCredentials'
    ProjectScopeParams:
      description: Specifies the parameters for project type scope.
      type: object
      required:
      - projectName
      - domainName
      properties:
        projectName:
          description: Specifies the project name.
          type:
          - string
          - 'null'
          x-order: 0
        domainName:
          description: Specifies the domain name of the project.
          type:
          - string
          - 'null'
          x-order: 1
    KeystoneAdminParams:
      description: Specifies administrator credentials of a Keystone.
      type: object
      required:
      - domain
      - username
      properties:
        domain:
          description: Specifies the administrator domain name.
          type:
          - string
          - 'null'
          x-order: 0
        username:
          description: Specifies the username of Keystone administrator.
          type:
          - string
          - 'null'
          x-order: 1
        password:
          description: Specifies the password of Keystone administrator.
          type:
          - string
          - 'null'
          x-order: 2
    DomainScopeParams:
      description: Specifies the parameters for domain type scope
      type: object
      required:
      - domainName
      properties:
        domainName:
          description: Specifies the domain name.
          type:
          - string
          - 'null'
          x-order: 0
    KeystoneCredentials:
      description: Specifies user credentials of a Keystone server.
      type: object
      required:
      - adminCreds
      - scope
      properties:
        adminCreds:
          description: Specifies parameters related to Keystone administrator.
          type: object
          allOf:
          - $ref: '#/components/schemas/KeystoneAdminParams'
          - {}
          x-order: 0
        scope:
          description: Specifies parameters related to Keystone scope.
          type: object
          allOf:
          - $ref: '#/components/schemas/KeystoneScopeParams'
          - {}
          x-order: 1
  responses:
    UpdateSwiftResponse:
      description: Success
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SwiftParams'
    ErrorResponse:
      description: Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NoContentResponse:
      description: No Content
    GetSwiftResponse:
      description: Success
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SwiftParams'
  securitySchemes:
    APIKeyHeader:
      in: header
      name: apiKey
      type: apiKey