Cisco Intersight Comm API

openapi: 3.2.0
info:
  description: 'Cisco Intersight is a management platform delivered as a service with embedded analytics for your Cisco and

    3rd party IT infrastructure. This platform offers an intelligent level of management that enables

    IT organizations to analyze, simplify, and automate their environments in more advanced ways than the prior

    generations of tools. Cisco Intersight provides an integrated and intuitive management experience for

    resources in the traditional data center as well as at the edge. With flexible deployment options to address

    complex security needs, getting started with Intersight is quick and easy.

    Cisco Intersight has deep integration with Cisco UCS and HyperFlex systems allowing for remote deployment,

    configuration, and ongoing maintenance. The model-based deployment works for a single system in a remote

    location or hundreds of systems in a data center and enables rapid, standardized configuration and deployment.

    It also streamlines maintaining those systems whether you are working with small or very large configurations.

    The Intersight OpenAPI document defines the complete set of properties that are returned in the

    HTTP response. From that perspective, a client can expect that no additional properties are returned,

    unless these properties are explicitly defined in the OpenAPI document.

    However, when a client uses an older version of the Intersight OpenAPI document, the server may

    send additional properties because the software is more recent than the client. In that case, the client

    may receive properties that it does not know about.

    Some generated SDKs perform a strict validation of the HTTP response body against the OpenAPI document.

    This document was created on 2026-08-07T06:46:04Z.'
  version: 1.0.11-20260807064027971
  title: Cisco Intersight Hyperflex Comm API
  license:
    name: Apache License, Version 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  contact:
    name: Intersight API support
    url: https://intersight.com/help
    email: intersight@cisco.com
  x-provenance:
    method: harvested
    authored_by: Cisco Intersight
    harvested_by: API Evangelist
    harvested_on: '2026-08-19'
    first_party: true
    provider_published: true
    source_host: cdn.intersight.com
    note: Cisco publishes the full Intersight OpenAPI 3.0.2 anonymously from its CDN (27.5MB master document; 3,963 operations / 2,448 paths / 5,612 schemas) plus 11 per-service documents covering 100% of the master's paths. Byte-identity reconfirmed 2026-08-19 by SHA-256. Note intersight.com itself is a soft-404 farm — the contract is on the CDN, not the app host.
  x-evidence:
  - type: source
    url: https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-openapi-v3-1.0.11-20260807064027971.json
  - type: source
    url: https://intersight.com/apidocs/apirefs/
servers:
- url: https://{server}
  variables:
    server:
      default: intersight.com
  description: The Intersight URL for the cloud-based infrastructure management APIs.
tags:
- name: comm
paths:
  /api/v1/comm/HttpProxyPolicies:
    get:
      tags:
      - comm
      x-intersight-type: SaaS
      summary: Read a 'comm.HttpProxyPolicy' resource.
      operationId: GetCommHttpProxyPolicyList
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Manage HyperFlex Cluster Profiles
        - PRIVSET.Read-Only
        - PRIVSET.Read-only HyperFlex cluster profiles
        - PRIVSET.View HyperFlex Cluster Profiles
        - READ.comm.HttpProxyPolicy
        - ROLE.Account Administrator
        - ROLE.Read-Only
      parameters:
      - $ref: '#/components/parameters/filterParam'
      - $ref: '#/components/parameters/orderbyParam'
      - $ref: '#/components/parameters/topParam'
      - $ref: '#/components/parameters/skipParam'
      - $ref: '#/components/parameters/selectParam'
      - $ref: '#/components/parameters/expandParam'
      - $ref: '#/components/parameters/applyParam'
      - $ref: '#/components/parameters/countParam'
      - $ref: '#/components/parameters/inlinecountParam'
      - $ref: '#/components/parameters/atParam'
      - $ref: '#/components/parameters/tagsParam'
      responses:
        '200':
          description: List of 'comm.HttpProxyPolicy' resources for the given filter criteria
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
            Content-Disposition:
              $ref: '#/components/headers/Content-Disposition'
            Content-Length:
              $ref: '#/components/headers/Content-Length'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/comm.HttpProxyPolicy.Response'
            text/csv:
              schema:
                $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/CsvFile
            application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
              schema:
                $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/ExcelFile
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    post:
      tags:
      - comm
      x-intersight-type: SaaS
      summary: Create a 'comm.HttpProxyPolicy' resource.
      operationId: CreateCommHttpProxyPolicy
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - CREATE.comm.HttpProxyPolicy
        - PRIVSET.Account Administrator
        - PRIVSET.Manage HyperFlex Cluster Profiles
        - ROLE.Account Administrator
      parameters:
      - $ref: '#/components/parameters/IfMatch'
      - $ref: '#/components/parameters/IfNoneMatch'
      requestBody:
        description: The 'comm.HttpProxyPolicy' resource to create.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/comm.HttpProxyPolicy'
      responses:
        '200':
          description: The HTTP 200 status response code indicates that the request has succeeded and the 'comm.HttpProxyPolicy' resource was created as requested. The 'comm.HttpProxyPolicy' resource is created before this response is sent back and the resource is returned in the body of the message.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/comm.HttpProxyPolicy'
          links:
            GetCommHttpProxyPolicyByMoid:
              operationId: GetCommHttpProxyPolicyByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/comm/HttpProxyPolicies/{Moid}'.
            GetIamAccountByMoid:
              $ref: '#/components/links/GetIamAccountByMoid'
            GetIamDomainGroupByMoid:
              $ref: '#/components/links/GetIamDomainGroupByMoid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
  /api/v1/comm/HttpProxyPolicies/{Moid}:
    get:
      tags:
      - comm
      x-intersight-type: SaaS
      summary: Read a 'comm.HttpProxyPolicy' resource.
      operationId: GetCommHttpProxyPolicyByMoid
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Manage HyperFlex Cluster Profiles
        - PRIVSET.Read-Only
        - PRIVSET.Read-only HyperFlex cluster profiles
        - PRIVSET.View HyperFlex Cluster Profiles
        - READ.comm.HttpProxyPolicy
        - ROLE.Account Administrator
        - ROLE.Read-Only
      parameters:
      - $ref: '#/components/parameters/moidParam'
      - $ref: '#/components/parameters/selectParam'
      - $ref: '#/components/parameters/expandParam'
      - $ref: '#/components/parameters/atParam'
      responses:
        '200':
          description: An instance of the 'comm.HttpProxyPolicy' resource.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
            Content-Disposition:
              $ref: '#/components/headers/Content-Disposition'
            Content-Length:
              $ref: '#/components/headers/Content-Length'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/comm.HttpProxyPolicy'
            text/csv:
              schema:
                $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/CsvFile
            application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
              schema:
                $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/ExcelFile
          links:
            GetCommHttpProxyPolicyByMoid:
              operationId: GetCommHttpProxyPolicyByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/comm/HttpProxyPolicies/{Moid}'.
            GetIamAccountByMoid:
              $ref: '#/components/links/GetIamAccountByMoid'
            GetIamDomainGroupByMoid:
              $ref: '#/components/links/GetIamDomainGroupByMoid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    post:
      tags:
      - comm
      x-intersight-type: SaaS
      summary: Update a 'comm.HttpProxyPolicy' resource.
      operationId: UpdateCommHttpProxyPolicy
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Manage HyperFlex Cluster Profiles
        - ROLE.Account Administrator
        - UPDATE.comm.HttpProxyPolicy
      parameters:
      - $ref: '#/components/parameters/moidParam'
      - $ref: '#/components/parameters/IfMatch'
      requestBody:
        description: The 'comm.HttpProxyPolicy' resource to update.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/comm.HttpProxyPolicy'
          application/json-patch+json:
            schema:
              $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/PatchDocument
      responses:
        '200':
          description: The HTTP 200 status response code indicates that the request has succeeded and the 'comm.HttpProxyPolicy' resource was modified as requested. The 'comm.HttpProxyPolicy' resource is modified before this response is sent back and the resource is returned in the body of the message.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/comm.HttpProxyPolicy'
          links:
            GetCommHttpProxyPolicyByMoid:
              operationId: GetCommHttpProxyPolicyByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/comm/HttpProxyPolicies/{Moid}'.
            GetIamAccountByMoid:
              $ref: '#/components/links/GetIamAccountByMoid'
            GetIamDomainGroupByMoid:
              $ref: '#/components/links/GetIamDomainGroupByMoid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    patch:
      tags:
      - comm
      x-intersight-type: SaaS
      summary: Update a 'comm.HttpProxyPolicy' resource.
      operationId: PatchCommHttpProxyPolicy
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Manage HyperFlex Cluster Profiles
        - ROLE.Account Administrator
        - UPDATE.comm.HttpProxyPolicy
      parameters:
      - $ref: '#/components/parameters/moidParam'
      - $ref: '#/components/parameters/IfMatch'
      requestBody:
        description: The 'comm.HttpProxyPolicy' resource to update.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/comm.HttpProxyPolicy'
          application/json-patch+json:
            schema:
              $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/PatchDocument
      responses:
        '200':
          description: The HTTP 200 status response code indicates that the request has succeeded and the 'comm.HttpProxyPolicy' resource was patched as requested. The 'comm.HttpProxyPolicy' resource is patched before this response is sent back and the resource is returned in the body of the message.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/comm.HttpProxyPolicy'
          links:
            GetCommHttpProxyPolicyByMoid:
              operationId: GetCommHttpProxyPolicyByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/comm/HttpProxyPolicies/{Moid}'.
            GetIamAccountByMoid:
              $ref: '#/components/links/GetIamAccountByMoid'
            GetIamDomainGroupByMoid:
              $ref: '#/components/links/GetIamDomainGroupByMoid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    delete:
      tags:
      - comm
      x-intersight-type: SaaS
      summary: Delete a 'comm.HttpProxyPolicy' resource.
      operationId: DeleteCommHttpProxyPolicy
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - DELETE.comm.HttpProxyPolicy
        - PRIVSET.Account Administrator
        - PRIVSET.Manage HyperFlex Cluster Profiles
        - ROLE.Account Administrator
      parameters:
      - $ref: '#/components/parameters/moidParam'
      responses:
        '200':
          description: Resource has been deleted successfully.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
  /api/v1/comm/TagDefinitions:
    post:
      tags:
      - comm
      x-intersight-type: SaaS
      summary: Create a 'comm.TagDefinition' resource.
      operationId: CreateCommTagDefinition
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - CREATE.comm.TagDefinition
        - PRIVSET.Account Administrator
        - PRIVSET.Manage Tags
        - ROLE.Account Administrator
      parameters:
      - $ref: '#/components/parameters/IfMatch'
      - $ref: '#/components/parameters/IfNoneMatch'
      requestBody:
        description: The 'comm.TagDefinition' resource to create.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/comm.TagDefinition'
      responses:
        '200':
          description: The HTTP 200 status response code indicates that the request has succeeded and the 'comm.TagDefinition' resource was created as requested. The 'comm.TagDefinition' resource is created before this response is sent back and the resource is returned in the body of the message.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/comm.TagDefinition'
          links:
            GetCommTagDefinitionByMoid:
              operationId: GetCommTagDefinitionByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/comm/TagDefinitions/{Moid}'.
            GetIamAccountByMoid:
              $ref: '#/components/links/GetIamAccountByMoid'
            GetIamDomainGroupByMoid:
              $ref: '#/components/links/GetIamDomainGroupByMoid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    get:
      tags:
      - comm
      x-intersight-type: SaaS
      summary: Read a 'comm.TagDefinition' resource.
      operationId: GetCommTagDefinitionList
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Global Read Privileges
        - PRIVSET.Global System Privileges
        - READ.comm.TagDefinition
      parameters:
      - $ref: '#/components/parameters/filterParam'
      - $ref: '#/components/parameters/orderbyParam'
      - $ref: '#/components/parameters/topParam'
      - $ref: '#/components/parameters/skipParam'
      - $ref: '#/components/parameters/selectParam'
      - $ref: '#/components/parameters/expandParam'
      - $ref: '#/components/parameters/applyParam'
      - $ref: '#/components/parameters/countParam'
      - $ref: '#/components/parameters/inlinecountParam'
      - $ref: '#/components/parameters/atParam'
      - $ref: '#/components/parameters/tagsParam'
      responses:
        '200':
          description: List of 'comm.TagDefinition' resources for the given filter criteria
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
            Content-Disposition:
              $ref: '#/components/headers/Content-Disposition'
            Content-Length:
              $ref: '#/components/headers/Content-Length'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/comm.TagDefinition.Response'
            text/csv:
              schema:
                $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/CsvFile
            application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
              schema:
                $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/ExcelFile
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
  /api/v1/comm/TagDefinitions/{Moid}:
    get:
      tags:
      - comm
      x-intersight-type: SaaS
      summary: Read a 'comm.TagDefinition' resource.
      operationId: GetCommTagDefinitionByMoid
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Global Read Privileges
        - PRIVSET.Global System Privileges
        - READ.comm.TagDefinition
      parameters:
      - $ref: '#/components/parameters/moidParam'
      - $ref: '#/components/parameters/selectParam'
      - $ref: '#/components/parameters/expandParam'
      - $ref: '#/components/parameters/atParam'
      responses:
        '200':
          description: An instance of the 'comm.TagDefinition' resource.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
            Content-Disposition:
              $ref: '#/components/headers/Content-Disposition'
            Content-Length:
              $ref: '#/components/headers/Content-Length'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/comm.TagDefinition'
            text/csv:
              schema:
                $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/CsvFile
            application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
              schema:
                $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/ExcelFile
          links:
            GetCommTagDefinitionByMoid:
              operationId: GetCommTagDefinitionByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/comm/TagDefinitions/{Moid}'.
            GetIamAccountByMoid:
              $ref: '#/components/links/GetIamAccountByMoid'
            GetIamDomainGroupByMoid:
              $ref: '#/components/links/GetIamDomainGroupByMoid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    post:
      tags:
      - comm
      x-intersight-type: SaaS
      summary: Update a 'comm.TagDefinition' resource.
      operationId: UpdateCommTagDefinition
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Manage Tags
        - ROLE.Account Administrator
        - UPDATE.comm.TagDefinition
      parameters:
      - $ref: '#/components/parameters/moidParam'
      - $ref: '#/components/parameters/IfMatch'
      requestBody:
        description: The 'comm.TagDefinition' resource to update.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/comm.TagDefinition'
          application/json-patch+json:
            schema:
              $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/PatchDocument
      responses:
        '200':
          description: The HTTP 200 status response code indicates that the request has succeeded and the 'comm.TagDefinition' resource was modified as requested. The 'comm.TagDefinition' resource is modified before this response is sent back and the resource is returned in the body of the message.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/comm.TagDefinition'
          links:
            GetCommTagDefinitionByMoid:
              operationId: GetCommTagDefinitionByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/comm/TagDefinitions/{Moid}'.
            GetIamAccountByMoid:
              $ref: '#/components/links/GetIamAccountByMoid'
            GetIamDomainGroupByMoid:
              $ref: '#/components/links/GetIamDomainGroupByMoid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    patch:
      tags:
      - comm
      x-intersight-type: SaaS
      summary: Update a 'comm.TagDefinition' resource.
      operationId: PatchCommTagDefinition
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Manage Tags
        - ROLE.Account Administrator
        - UPDATE.comm.TagDefinition
      parameters:
      - $ref: '#/components/parameters/moidParam'
      - $ref: '#/components/parameters/IfMatch'
      requestBody:
        description: The 'comm.TagDefinition' resource to update.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/comm.TagDefinition'
          application/json-patch+json:
            schema:
              $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/PatchDocument
      responses:
        '200':
          description: The HTTP 200 status response code indicates that the request has succeeded and the 'comm.TagDefinition' resource was patched as requested. The 'comm.TagDefinition' resource is patched before this response is sent back and the resource is returned in the body of the message.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/comm.TagDefinition'
          links:
            GetCommTagDefinitionByMoid:
              operationId: GetCommTagDefinitionByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/comm/TagDefinitions/{Moid}'.
            GetIamAccountByMoid:
              $ref: '#/components/links/GetIamAccountByMoid'
            GetIamDomainGroupByMoid:
              $ref: '#/components/links/GetIamDomainGroupByMoid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
    delete:
      tags:
      - comm
      x-intersight-type: SaaS
      summary: Delete a 'comm.TagDefinition' resource.
      operationId: DeleteCommTagDefinition
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - DELETE.comm.TagDefinition
        - PRIVSET.Account Administrator
        - PRIVSET.Manage Tags
        - ROLE.Account Administrator
      parameters:
      - $ref: '#/components/parameters/moidParam'
      responses:
        '200':
          description: Resource has been deleted successfully.
          headers:
            Set-Cookie:
              $ref: '#/components/headers/Set-Cookie'
            x-starship-traceid:
              $ref: '#/components/headers/x-starship-traceid'
        '400':
          $ref: '#/components/responses/http_status_400'
        '401':
          $ref: '#/components/responses/http_status_401'
        '403':
          $ref: '#/components/responses/http_status_403'
        '404':
          $ref: '#/components/responses/http_status_404'
        default:
          $ref: '#/components/responses/default'
components:
  headers:
    x-starship-traceid:
      description: A value that uniquely identifies a HTTP request and its response.
      schema:
        type: string
    Set-Cookie:
      description: Cookie authentication key for use with the `cookieAuth` apiKey authentication.
      schema:
        type: string
        example: X-Starship-Token=abcde12345; Path=/
    Content-Length:
      description: Indicates the size of the entity-body, in bytes, sent to the recipient.
      schema:
        type: integer
    Content-Disposition:
      description: If not present, indicates the response content is expected to be displayed inline in the browser, that is, as a Web page or as part of a Web page. If present, indicates the response content is expected to be an attachment, that is downloaded and saved locally.
      schema:
        type: string
  schemas:
    comm.TagDefinition.Response:
      description: "The response body of a HTTP GET request for the 'comm.TagDefinition' resource.\nThe value may be one of the following types.\n1. When 'tag' is specified in the URL query, the response schema\n    is a summary of the tag usage.\n1. When '$apply' is specified in the URL query, the response schema\n    is dynamically-generated schema based on the $apply value.\n1. When '$count' is specified in the URL query, the response is\n    a simple object providing the count of the resources.\n1. In all other cases, the response is a list of 'comm.TagDefinition' resources."
      x-one-of-name: comm.TagDefinition.Response
      oneOf:
      - $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/mo.DocumentCount
      - $ref: '#/components/schemas/comm.TagDefinition.List'
      - $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/mo.AggregateTransform
      - $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/mo.TagSummary
      discriminator:
        propertyName: ObjectType
    hyperflex.HxNetworkAddressDt:
      title: Hyperflex:Hx Network Address Dt
      description: A network address. If both IP and FQDN are specified, IP is used. If only IP is specified, IP is used. If only FQDN is specified, FQDN is used. If both are not specified, it is an error.
      x-allOf-name: hyperflex.HxNetworkAddressDt
      allOf:
      - $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/mo.BaseComplexType
      - type: object
        description: Definition of the list of properties defined in 'hyperflex.HxNetworkAddressDt', excluding properties defined in parent classes.
        required:
        - ClassId
        - ObjectType
        properties:
          ClassId:
            description: 'The fully-qualified name of the instantiated, concrete type.

              This property is used as a discriminator to identify the type of the payload

              when marshaling and unmarshaling data.'
  

# --- truncated at 32 KB (648 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/intersight/refs/heads/main/openapi/intersight-comm-api-openapi.yml