How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cisco Intersight Recommendation API

The recommendation API from Cisco Intersight — 16 operation(s) for recommendation.

Cisco Intersight Recommendation API is one of 117 APIs that Cisco Intersight publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Recommendation. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

This API exposes 25 operations across 16 paths, and defines 40 schemas. It is described by OpenAPI 3.2.0, at version 1.0.11-20260807064027971.

Requests are made against a single base URL, https://{server}.

25 operations 16 paths 40 schemas 16 GET3 PATCH6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.11-20260807064027971
Base URL
https://intersight.com
Authentication
API Key, HTTP Signature, OAuth 2.0
Resource Areas
1

Authentication & Security 3

Cisco Intersight Recommendation API declares 3 security schemes for authenticating requests. An API key is passed in the cookie as X-Starship-Token (cookieAuth). It uses HTTP signature authentication (http_signature). It supports OAuth 2.0 (oAuth2) using the authorizationCode and clientCredentials flows, exposing 3315 scopes.

  • cookieAuth — The authentication cookie obtained from a Single-Sign-On SAML assertion.
  • http_signature — The 'HTTP signature' security scheme. Each HTTP request is cryptographically signed as specified in https://datatracker.ietf.org/doc/draft-cavage-http-signatur…
  • oAuth2 — The client uses the OAuth2 security scheme. To use OAuth2, a client application must be registered by creating a iam.AppRegistration resource. The user who cre…

Paths & Operations 25

Across 16 paths, the API surfaces 25 operations — 16 GET, 3 PATCH, 6 POST. Each is listed below with its method, path, parameters, and response codes.

recommendation 25
GET
/api/v1/recommendation/CapacityRunways
Read a 'recommendation.CapacityRunway' resource.
GetRecommendationCapacityRunwayList 11 params → 200400401403404default
GET
/api/v1/recommendation/CapacityRunways/{Moid}
Read a 'recommendation.CapacityRunway' resource.
GetRecommendationCapacityRunwayByMoid 4 params → 200400401403404default
GET
/api/v1/recommendation/ClusterExpansions
Read a 'recommendation.ClusterExpansion' resource.
GetRecommendationClusterExpansionList 11 params → 200400401403404default
GET
/api/v1/recommendation/ClusterExpansions/{Moid}
Read a 'recommendation.ClusterExpansion' resource.
GetRecommendationClusterExpansionByMoid 4 params → 200400401403404default
GET
/api/v1/recommendation/HardwareExpansionRequests
Read a 'recommendation.HardwareExpansionRequest' resource.
GetRecommendationHardwareExpansionRequestList 11 params → 200400401403404default
POST
/api/v1/recommendation/HardwareExpansionRequests
Create a 'recommendation.HardwareExpansionRequest' resource.
CreateRecommendationHardwareExpansionRequest 2 params body → 200400401403404default
GET
/api/v1/recommendation/HardwareExpansionRequests/{Moid}
Read a 'recommendation.HardwareExpansionRequest' resource.
GetRecommendationHardwareExpansionRequestByMoid 4 params → 200400401403404default
POST
/api/v1/recommendation/HardwareExpansionRequests/{Moid}
Update a 'recommendation.HardwareExpansionRequest' resource.
UpdateRecommendationHardwareExpansionRequest 2 params body → 200400401403404default
PATCH
/api/v1/recommendation/HardwareExpansionRequests/{Moid}
Update a 'recommendation.HardwareExpansionRequest' resource.
PatchRecommendationHardwareExpansionRequest 2 params body → 200400401403404default
GET
/api/v1/recommendation/HardwareExpansionRequestItems
Read a 'recommendation.HardwareExpansionRequestItem' resource.
GetRecommendationHardwareExpansionRequestItemList 11 params → 200400401403404default
POST
/api/v1/recommendation/HardwareExpansionRequestItems
Create a 'recommendation.HardwareExpansionRequestItem' resource.
CreateRecommendationHardwareExpansionRequestItem 2 params body → 200400401403404default
GET
/api/v1/recommendation/HardwareExpansionRequestItems/{Moid}
Read a 'recommendation.HardwareExpansionRequestItem' resource.
GetRecommendationHardwareExpansionRequestItemByMoid 4 params → 200400401403404default
POST
/api/v1/recommendation/HardwareExpansionRequestItems/{Moid}
Update a 'recommendation.HardwareExpansionRequestItem' resource.
UpdateRecommendationHardwareExpansionRequestItem 2 params body → 200400401403404default
PATCH
/api/v1/recommendation/HardwareExpansionRequestItems/{Moid}
Update a 'recommendation.HardwareExpansionRequestItem' resource.
PatchRecommendationHardwareExpansionRequestItem 2 params body → 200400401403404default
GET
/api/v1/recommendation/PhysicalItems
Read a 'recommendation.PhysicalItem' resource.
GetRecommendationPhysicalItemList 11 params → 200400401403404default
GET
/api/v1/recommendation/PhysicalItems/{Moid}
Read a 'recommendation.PhysicalItem' resource.
GetRecommendationPhysicalItemByMoid 4 params → 200400401403404default
GET
/api/v1/recommendation/PurchaseOrderEstimatesdeprecated
Read a 'recommendation.PurchaseOrderEstimate' resource.
GetRecommendationPurchaseOrderEstimateList 11 params → 200400401403404default
POST
/api/v1/recommendation/PurchaseOrderEstimatesdeprecated
Create a 'recommendation.PurchaseOrderEstimate' resource.
CreateRecommendationPurchaseOrderEstimate 2 params body → 200400401403404default
GET
/api/v1/recommendation/PurchaseOrderEstimates/{Moid}deprecated
Read a 'recommendation.PurchaseOrderEstimate' resource.
GetRecommendationPurchaseOrderEstimateByMoid 4 params → 200400401403404default
POST
/api/v1/recommendation/PurchaseOrderEstimates/{Moid}deprecated
Update a 'recommendation.PurchaseOrderEstimate' resource.
UpdateRecommendationPurchaseOrderEstimate 2 params body → 200400401403404default
PATCH
/api/v1/recommendation/PurchaseOrderEstimates/{Moid}deprecated
Update a 'recommendation.PurchaseOrderEstimate' resource.
PatchRecommendationPurchaseOrderEstimate 2 params body → 200400401403404default
GET
/api/v1/recommendation/PurchaseOrderLists
Read a 'recommendation.PurchaseOrderList' resource.
GetRecommendationPurchaseOrderListList 11 params → 200400401403404default
GET
/api/v1/recommendation/PurchaseOrderLists/{Moid}
Read a 'recommendation.PurchaseOrderList' resource.
GetRecommendationPurchaseOrderListByMoid 4 params → 200400401403404default
GET
/api/v1/recommendation/SoftwareItems
Read a 'recommendation.SoftwareItem' resource.
GetRecommendationSoftwareItemList 11 params → 200400401403404default
GET
/api/v1/recommendation/SoftwareItems/{Moid}
Read a 'recommendation.SoftwareItem' resource.
GetRecommendationSoftwareItemByMoid 4 params → 200400401403404default

Schemas 40

The contract defines 40 schemas that model the data the API accepts and returns. Each schema is shown below with its type and property counts.

recommendation.HardwareExpansionRequest.Relationship
A relationship to the 'recommendation.HardwareExpansionRequest' resource, or the expanded 'recommendation.HardwareExpansionRequest' resource, or the 'null' val…
recommendation.ClusterExpansion.List
This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.
recommendation.PurchaseOrderList.Response
The response body of a HTTP GET request for the 'recommendation.PurchaseOrderList' resource. The value may be one of the following types. 1. When 'tag' is spec…
recommendation.CapacityRunway.Response
The response body of a HTTP GET request for the 'recommendation.CapacityRunway' resource. The value may be one of the following types. 1. When 'tag' is specifi…
recommendation.HardwareExpansionRequestItem.Response
The response body of a HTTP GET request for the 'recommendation.HardwareExpansionRequestItem' resource. The value may be one of the following types. 1. When 't…
recommendation.Base
Entity representing recommendation base properties like name and last updated time.
recommendation.PhysicalItem
Entity representing the recommended physical device.
recommendation.SoftwareItem.Relationship
A relationship to the 'recommendation.SoftwareItem' resource, or the expanded 'recommendation.SoftwareItem' resource, or the 'null' value.
recommendation.HardwareExpansionRequestItem.List
This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.
recommendation.SoftwareItem.Response
The response body of a HTTP GET request for the 'recommendation.SoftwareItem' resource. The value may be one of the following types. 1. When 'tag' is specified…
recommendation.ClusterExpansion.Response
The response body of a HTTP GET request for the 'recommendation.ClusterExpansion' resource. The value may be one of the following types. 1. When 'tag' is speci…
forecast.Definition.Relationship
A relationship to the 'forecast.Definition' resource, or the expanded 'forecast.Definition' resource, or the 'null' value.
recommendation.PurchaseOrderList
Entity representing the list of items in csv format for the current recommendation. This can be used to generate an estimate by uploading it to Cisco Commerce…
recommendation.PurchaseOrderEstimate.Response
The response body of a HTTP GET request for the 'recommendation.PurchaseOrderEstimate' resource. The value may be one of the following types. 1. When 'tag' is…
recommendation.PhysicalItem.List
This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.
forecast.Model
Model encapsulates model type and the model generated based on the type for computing forecast. For example if linear regression predictive modeling is used th…
recommendation.PurchaseOrderEstimate.List
This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.
recommendation.ClusterExpansion.Relationship
A relationship to the 'recommendation.ClusterExpansion' resource, or the expanded 'recommendation.ClusterExpansion' resource, or the 'null' value.
recommendation.SoftwareItem
Entity representing the software recommendation for the managed end point.
recommendation.CapacityRunway.Relationship
A relationship to the 'recommendation.CapacityRunway' resource, or the expanded 'recommendation.CapacityRunway' resource, or the 'null' value.
forecast.Definition
Definition for forecast metric settings.
recommendation.PhysicalItem.Relationship
A relationship to the 'recommendation.PhysicalItem' resource, or the expanded 'recommendation.PhysicalItem' resource, or the 'null' value.
recommendation.SoftwareItem.List
This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.
recommendation.HardwareExpansionRequest
Entity representing the user request for HyperFlex cluster expansion.
recommendation.AbstractItem
Abstract object representing the recommended physical item.
forecast.Instance
Entity representing forecast result for instance of managed object, ie, data source.
forecast.Catalog.Relationship
A relationship to the 'forecast.Catalog' resource, or the expanded 'forecast.Catalog' resource, or the 'null' value.
forecast.Catalog
A catalog for managing forecast settings.
recommendation.HardwareExpansionRequestItem
Entity representing the user request for expansion of each hardware item.
recommendation.HardwareExpansionRequestItem.Relationship
A relationship to the 'recommendation.HardwareExpansionRequestItem' resource, or the expanded 'recommendation.HardwareExpansionRequestItem' resource, or the 'n…
forecast.Instance.Relationship
A relationship to the 'forecast.Instance' resource, or the expanded 'forecast.Instance' resource, or the 'null' value.
recommendation.PurchaseOrderEstimate
Entity representing the estimate for the purchase order for user requested expansion.
recommendation.CapacityRunway.List
This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.
recommendation.HardwareExpansionRequest.List
This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.
recommendation.PhysicalItem.Response
The response body of a HTTP GET request for the 'recommendation.PhysicalItem' resource. The value may be one of the following types. 1. When 'tag' is specified…
recommendation.ExpansionRequest
Entity representing hardware expansion request like name, requestTime, etc.
recommendation.ClusterExpansion
Entity representing the cluster expansion recommendations.
recommendation.HardwareExpansionRequest.Response
The response body of a HTTP GET request for the 'recommendation.HardwareExpansionRequest' resource. The value may be one of the following types. 1. When 'tag'…
recommendation.CapacityRunway
Entity representing the new capacity runway based on recommendations.
recommendation.PurchaseOrderList.List
This resource list is returned as a response to a HTTP GET request that does not include a specific resource identifier.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

intersight-recommendation-api-openapi.yml Raw ↑

Other APIs Cisco Intersight publishes across the network.

Cisco Intersight Aaa API
Cisco Intersight Access API
Cisco Intersight Adapter API
Cisco Intersight Apiproxy API
Cisco Intersight Appliance API
Cisco Intersight Asset API
Cisco Intersight Auditd API
Cisco Intersight Bios API
Cisco Intersight Boot API
Cisco Intersight Bulk API
Cisco Intersight Capability API
Cisco Intersight Catalystsdwan API
Where this information came from

This is an independent, third-party profile of Cisco Intersight Recommendation API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.