# Cisco Intersight

> Cisco Intersight is Cisco's SaaS operations platform for UCS servers, HyperFlex clusters, Nexus fabrics,
> third-party storage and virtualization — provisioning, firmware lifecycle, workload optimization, telemetry
> and Kubernetes service delivery. The full REST contract is published anonymously as OpenAPI 3.0.2:
> 3,963 operations across 2,448 paths and 5,612 schemas.

Base URL: https://intersight.com  (all operations under /api/v1)
Spec version: 1.0.11-20260807064027971

## Contract

- [OpenAPI (combined, 27.5 MB)](https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/intersight-openapi-v3-1.0.11-20260807064027971.json): the whole API in one document.
- [Service index](https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/api-ref-services.json): names the twelve per-service split documents. The eleven non-SDK splits together cover all 2,448 paths with nothing left over.
- [API reference](https://intersight.com/apidocs/apirefs/): browsable reference with a built-in REST client.
- [Overview](https://intersight.com/apidocs/introduction/overview/)
- [Changelog](https://intersight.com/apidocs/introduction/changelog/) and its [machine-readable feed](https://cdn.intersight.com/components/an-apidocs/1.0.11-20260807064027971/model/changelog-2026.json): a per-release OpenAPI diff with a boolean `breaking` flag on every change.

## Authentication

- **HTTP Signature** (draft-cavage-http-signatures) with an API key id and secret — the programmatic path. Sign `(request-target)`, `(created)`, `Host`, `Date`, `Digest`.
- **OAuth 2.0** — authorization code (`/iam/app-authorize`, `/iam/token`) with 54 `ROLE.*` scopes, or client credentials with fine-grained `CREATE.*`/`READ.*`/`UPDATE.*`/`DELETE.*` scopes. 3,317 scopes in total.
- **Cookie** (`X-Starship-Token`) — browser SSO sessions only, not for clients.

## Calling conventions

- **Query**: OData-style — `$filter`, `$orderby`, `$select`, `$expand`, `$apply` (groupby/aggregate), `$top`, `$skip`, `$count`, `$inlinecount`, plus `at` and `tags`.
- **Pagination**: offset, `$top` (default 100) and `$skip`.
- **Identifiers**: every resource carries a 24-character `Moid`, plus `ObjectType` and `ClassId`. References are modelled as `<Type>Relationship` objects, so the entity graph is machine-derivable.
- **Retry safety**: no `Idempotency-Key`. Use `If-None-Match: *` on creates and `If-Match: <ModTime>` on updates; a conflict returns 412 Precondition Failed.
- **Async**: `Prefer: respond-async` (RFC 7240) returns 202. Long-running work is otherwise modelled as pollable resources (`workflow.WorkflowInfo`, `bulk.Request`).
- **Errors**: `{code, messageId, message}` on `application/json`. `code` is an 11-value closed enum. Every error response carries an `x-starship-traceid` header.
- **Rate limits**: none published. No `429` and no `Retry-After` anywhere in the contract.
- **Exports**: 2,398 list operations also serve `text/csv` and XLSX.

## Clients

- [Python](https://pypi.org/project/intersight/) `pip install intersight` — 1.0.11.2026072720
- [PowerShell](https://www.powershellgallery.com/packages/Intersight.PowerShell) — 1.0.11.2026072720
- [Go](https://github.com/CiscoDevNet/intersight-go)
- [Terraform](https://registry.terraform.io/providers/CiscoDevNet/intersight/latest) — 1.0.79
- [Ansible](https://galaxy.ansible.com/ui/repo/published/cisco/intersight/) `cisco.intersight` — 2.21.0
- [Postman collection](https://github.com/CiscoDevNet/intersight-postman)

## Operations

- [Status page](https://status.intersight.com/) — "Intersight API Services" is a separately reported component.
- [Security disclosure](https://www.cisco.com/.well-known/security.txt) — Cisco PSIRT, psirt@cisco.com, with CSAF advisories.
- [Licensing](https://www.cisco.com/site/us/en/products/computing/hybrid-cloud-operations/intersight-platform/licensing.html) — two tiers, Essentials and Advantage; no public price; 90-day Advantage trial on new accounts.

## Not available

- No MCP server, no A2A agent card, no GraphQL, no AsyncAPI and no documented webhook catalog.
- No `/.well-known/*` document and no `llms.txt` on intersight.com — all return a real 404.

---
Generated by API Evangelist from Cisco's own published artifacts. Independent third-party profile; not affiliated with Cisco.