Cisco Intersight certificate management 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.'
  version: 1.0.11-20260807064027971
  title: Cisco Intersight Server Certificatemanagement 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: certificate management
paths:
  /api/v1/certificatemanagement/Policies:
    get:
      tags:
      - certificate management
      summary: Read a 'certificatemanagement.Policy' resource
      operationId: GetCertificatemanagementPolicyList
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Manage Server Profiles
        - PRIVSET.Manage Switch Profiles
        - PRIVSET.Read-Only
        - PRIVSET.Read-only Certificate Management policies
        - PRIVSET.View Server Profiles
        - PRIVSET.View Switch Profiles
        - READ.certificatemanagement.Policy
        - 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 'certificatemanagement.Policy' 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/certificatemanagement.Policy.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:
      - certificate management
      summary: Create a 'certificatemanagement.Policy' resource
      operationId: CreateCertificatemanagementPolicy
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - CREATE.certificatemanagement.Policy
        - PRIVSET.Account Administrator
        - PRIVSET.Create, clone and edit Certificate Management policies
        - PRIVSET.Manage Server Profiles
        - PRIVSET.Manage Switch Profiles
        - ROLE.Account Administrator
      parameters:
      - $ref: '#/components/parameters/IfMatch'
      - $ref: '#/components/parameters/IfNoneMatch'
      requestBody:
        description: The 'certificatemanagement.Policy' resource to create.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/certificatemanagement.Policy'
      responses:
        '200':
          description: The HTTP 200 status response code indicates that the request has succeeded and the 'certificatemanagement.Policy' resource was created as requested. The 'certificatemanagement.Policy' 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/certificatemanagement.Policy'
          links:
            GetCertificatemanagementPolicyByMoid:
              operationId: GetCertificatemanagementPolicyByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/certificatemanagement/Policies/{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/certificatemanagement/Policies/{Moid}:
    get:
      tags:
      - certificate management
      summary: Read a 'certificatemanagement.Policy' resource
      operationId: GetCertificatemanagementPolicyByMoid
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Manage Server Profiles
        - PRIVSET.Manage Switch Profiles
        - PRIVSET.Read-Only
        - PRIVSET.Read-only Certificate Management policies
        - PRIVSET.View Server Profiles
        - PRIVSET.View Switch Profiles
        - READ.certificatemanagement.Policy
        - 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 'certificatemanagement.Policy' 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/certificatemanagement.Policy'
            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:
            GetCertificatemanagementPolicyByMoid:
              operationId: GetCertificatemanagementPolicyByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/certificatemanagement/Policies/{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:
      - certificate management
      summary: Update a 'certificatemanagement.Policy' resource
      operationId: UpdateCertificatemanagementPolicy
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Edit Certificate Management policies
        - PRIVSET.Manage Server Profiles
        - PRIVSET.Manage Switch Profiles
        - ROLE.Account Administrator
        - UPDATE.certificatemanagement.Policy
      parameters:
      - $ref: '#/components/parameters/moidParam'
      - $ref: '#/components/parameters/IfMatch'
      requestBody:
        description: The 'certificatemanagement.Policy' resource to update.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/certificatemanagement.Policy'
          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 'certificatemanagement.Policy' resource was modified as requested. The 'certificatemanagement.Policy' 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/certificatemanagement.Policy'
          links:
            GetCertificatemanagementPolicyByMoid:
              operationId: GetCertificatemanagementPolicyByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/certificatemanagement/Policies/{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:
      - certificate management
      summary: Update a 'certificatemanagement.Policy' resource
      operationId: PatchCertificatemanagementPolicy
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Edit Certificate Management policies
        - PRIVSET.Manage Server Profiles
        - PRIVSET.Manage Switch Profiles
        - ROLE.Account Administrator
        - UPDATE.certificatemanagement.Policy
      parameters:
      - $ref: '#/components/parameters/moidParam'
      - $ref: '#/components/parameters/IfMatch'
      requestBody:
        description: The 'certificatemanagement.Policy' resource to update.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/certificatemanagement.Policy'
          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 'certificatemanagement.Policy' resource was patched as requested. The 'certificatemanagement.Policy' 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/certificatemanagement.Policy'
          links:
            GetCertificatemanagementPolicyByMoid:
              operationId: GetCertificatemanagementPolicyByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/certificatemanagement/Policies/{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:
      - certificate management
      summary: Delete a 'certificatemanagement.Policy' resource
      operationId: DeleteCertificatemanagementPolicy
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - DELETE.certificatemanagement.Policy
        - PRIVSET.Account Administrator
        - PRIVSET.Delete Certificate Management policies
        - PRIVSET.Manage Server Profiles
        - PRIVSET.Manage Switch 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/certificatemanagement/PolicyInventories:
    get:
      tags:
      - certificate management
      summary: Read a 'certificatemanagement.PolicyInventory' resource
      operationId: GetCertificatemanagementPolicyInventoryList
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Manage Server Profiles
        - PRIVSET.Manage Switch Profiles
        - PRIVSET.Read-Only
        - PRIVSET.Read-only Certificate Management policies
        - PRIVSET.View Server Profiles
        - PRIVSET.View Switch Profiles
        - READ.certificatemanagement.PolicyInventory
        - 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 'certificatemanagement.PolicyInventory' 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/certificatemanagement.PolicyInventory.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/certificatemanagement/PolicyInventories/{Moid}:
    get:
      tags:
      - certificate management
      summary: Read a 'certificatemanagement.PolicyInventory' resource
      operationId: GetCertificatemanagementPolicyInventoryByMoid
      security:
      - cookieAuth: []
      - http_signature: []
      - oAuth2:
        - PRIVSET.Account Administrator
        - PRIVSET.Manage Server Profiles
        - PRIVSET.Manage Switch Profiles
        - PRIVSET.Read-Only
        - PRIVSET.Read-only Certificate Management policies
        - PRIVSET.View Server Profiles
        - PRIVSET.View Switch Profiles
        - READ.certificatemanagement.PolicyInventory
        - 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 'certificatemanagement.PolicyInventory' 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/certificatemanagement.PolicyInventory'
            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:
            GetCertificatemanagementPolicyInventoryByMoid:
              operationId: GetCertificatemanagementPolicyInventoryByMoid
              parameters:
                Moid: $response.body#/Moid
              description: The 'Moid' value returned in the response can be used as the 'Moid' parameter in 'GET /api/v1/certificatemanagement/PolicyInventories/{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'
components:
  responses:
    http_status_404:
      description: The specified resource was not found. The HTTP body contains a document that provides more details about the error.
      headers:
        x-starship-traceid:
          $ref: '#/components/headers/x-starship-traceid'
      content:
        application/json:
          schema:
            $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/Error
    http_status_401:
      description: 'The request requires user authentication. The client may repeat the request with a suitable Authorization header field.

        If the request already included Authorization credentials, then the 401 response indicates that authorization has

        been refused for those credentials.

        The HTTP body may contain a document that provides more details about the error.'
      headers:
        x-starship-traceid:
          $ref: '#/components/headers/x-starship-traceid'
      content:
        application/json:
          schema:
            $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/Error
    http_status_400:
      description: 'The request could not be understood by the server due to malformed syntax.

        The client SHOULD NOT repeat the request without modifications.

        For example, the request may contain an incorrect JSON syntax, or the request fails

        validation checks.

        The HTTP body may contain a document that provides more details about the error.'
      headers:
        x-starship-traceid:
          $ref: '#/components/headers/x-starship-traceid'
      content:
        application/json:
          schema:
            $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/Error
    http_status_403:
      description: 'The request was properly authenticated, but the server is refusing to fulfill it.

        The HTTP body may contain a document that provides more details about the error.

        For example, the user may not have sufficient privileges to perform the request.'
      headers:
        x-starship-traceid:
          $ref: '#/components/headers/x-starship-traceid'
      content:
        application/json:
          schema:
            $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/Error
    default:
      description: An unexpected error occurred.
      headers:
        x-starship-traceid:
          $ref: '#/components/headers/x-starship-traceid'
      content:
        application/json:
          schema:
            $ref: intersight-system-v3-1.0.11-20260807064027971.json#/components/schemas/Error
  parameters:
    selectParam:
      name: $select
      in: query
      description: Specifies a subset of properties to return.
      required: false
      schema:
        type: string
        default: ''
      examples:
        select:
          summary: Return a summary list of resources. The response will include the Moid, which is always returned, and the 'CreateTime' and 'ModTime' properties.
          value: $select=CreateTime,ModTime
        select_filtered:
          summary: Return a filtered, summary list of resources.
          value: $select=CreateTime,ModTime&$filter=CreateTime gt now() sub PT2H
          description: 'Return a summary list of resources. The response will include the Moid, which is always returned even if it is not specified in the $select query,

            and the ''CreateTime'' and ''ModTime'' properties, which are explicitly specified in the $select query.

            The results are filtered and only include the resources that were created less than two hours ago.'
    moidParam:
      name: Moid
      in: path
      required: true
      description: The unique Moid identifier of a resource instance.
      schema:
        type: string
    inlinecountParam:
      name: $inlinecount
      in: query
      description: The $inlinecount query option allows clients to request an inline count of the matching resources included with the resources in the response.
      required: false
      allowEmptyValue: false
      schema:
        type: string
        enum:
        - allpages
        - none
        default: allpages
      examples:
        inlinecount_output:
          summary: Return the count of the resources, and an array containing the resources.
          value: $inlinecount=true
        inlinecount_filtered:
          summary: Return the count of the resources that were created less than two hours ago, and an array containing the resources.
          value: $inlinecount=true&$filter=CreateTime gt now() sub PT2H
    expandParam:
      name: $expand
      in: query
      description: Specify additional attributes or related resources to return in addition to the primary resources.
      required: false
      schema:
        type: string
      examples:
        expand_displaynames:
          summary: Return the resources.
          value: $expand=DisplayNames
    countParam:
      name: $count
      in: query
      description: The $count query specifies the service should return the count of the matching resources, instead of returning the resources.
      required: false
      allowEmptyValue: false
      schema:
        type: boolean
      examples:
        total_count:
          summary: Return the count of the resources.
          value: $count=true
        count_filtered:
          summary: Return the count of resources that were created less than two hours ago.
          value: $count=true&$filter=CreateTime gt now() sub PT2H
    orderbyParam:
      name: $orderby
      in: query
      description: Determines what properties are used to sort the collection of resources.
      required: false
      schema:
        type: string
      examples:
        date_sort_ascending:
          summary: Return the resources, sorted by creation time in ascending order, i.e., oldest resources first.
          value: $orderby=CreationTime
        date_sort_descending:
          summary: Return the resources, sorted by creation time in descending order, i.e., most recently created resources first.
          value: $orderby=-CreationTime
        date_sort_filtered_descending:
          summary: Return the resources that have been modified less than 80 minutes ago, sorted by modification time, most recently modified resources first.
          value: $orderby=-ModTime&$filter=ModTime gt now() sub PT80M
        sorted_results_with_paging:
          summary: Return the first 20 resources sorted by modification time.
          value: $top=20&$orderby=ModTime
    skipParam:
      name: $skip
      in: query
      description: Specifies the number of resources to skip in the response.
      required: false
      allowEmptyValue: false
      schema:
        type: integer
        format: int32
        default: 0
      examples:
        skip:
          summary: Return the resources. Skip the first 100 resources.
          value: $skip=100
        skip_and_top:
          summary: Return the resources. Skip the first 100 resources and return up to 20 resources.
          value: $skip=100&$top=20
        skip_with_filter:
          summary: Return the resources that were created less than two hours ago. Skip the first 100 resources and return up to 20 resources.
          value: $skip=100&$top=20&$filter=CreateTime gt now() sub PT2H
    filterParam:
      name: $filter
      in: query
      description: 'Filter criteria for the resources to return.

        A URI with a $filter query option identifies a subset of the entries from the Collection of Entries. The subset is determined by selecting

        only the Entries that satisfy the predicate expression specified by the $filter option.

        The expression language that is used in $filter queries supports references to properties and

        literals. The literal values can be strings enclosed in single quotes, numbers and boolean values

        (true or false).'
      required: false
      schema:
        type: string
        default: ''
      examples:
        property_createTime_gt:
          summary: Return the resources where the 'CreateTime' property is greater than the specified date.
          value: $filter=CreateTime gt 2012-08-29T21:58:33Z
        property_createTime_gt_now:
          summary: Return the resources that were created less than seventy-two hours ago.
          value: $filter=CreateTime gt now() sub PT72H
          description: 'This example uses a filter expression to compare the ''CreateTime'' property of the resource against the current time.

            The now() function is resolved to the current time in the Intersight service when the query is processed.

            ''PT72H'' is a string value that represents 72 hours.

            See https://intersight.com/apidocs for more details about how to construct a duration.

            The "sub" operator is used to substract a duration from the current time.'
        property_createTime_lt_now:
          summary: Return the resources that were created at least 60 days ago.
          value: $filter=CreateTime lt now() sub P60D
        property_modTime_gt_now1:
          summary: Return the resources that were modified less than three minutes and 20 seconds ago.
          value: $filter=ModTime gt now() sub PT3M20S
        property_modTime_gt_now2:
          summary: Return the resources that were modified less than 90 days ago.
          value: $filter=ModTime gt now() sub P90D
        property_modTime_gt_now3:
          summary: Return the resources that were modified less than 1 day and 12 hours ago.
          value: $filter=ModTime gt now() sub P1DT12H
    tagsParam:
      name: tags
      in: query
      description: The 'tags' parameter is used to request a summary of the Tag utilization for this resource. When the 'tags' parameter is specified, the response provides a list of tag keys, the number of times the key has been used across all documents, and the tag values that have been assigned to the tag key.
      required: false
      schema:
        type: string
    topParam:
      name: $top
      in: query
      description: Specifies the maximum number of resources to return in the response.
      required: false
      allowEmptyValue: false
      schema:
        type: integer
        format: int32
        default: 100
      examples:
        top:
          summary: Return up to 10 resources.
          value: $top=10
        top_with_filter:
          summary: Return up to 20 resources that were created less than two hours ago.
          value: $top=20&$filter=CreateTime gt now() sub PT2H
    IfNoneMatch:
      name: If-None-Match
      in: header
      description: 'For methods that apply server-side changes, If-None-Match used with the * value can be used to create

        a resource not known to exist, guaranteeing that another resource creation didn''t happen before,

        losing the data of the previous put. The request will be processed only if the eventually existing

        resource''s ETag doesn''t match any of the values listed. Otherwise, the status code 412

        (Precondition Failed) is used.

        The asteris

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