{"type":"model","meta":{"id":"/apps/pubhub/media/tortuga-api-documentation/3cc3d8999db06d62b96cfb1550f6aea184cf267d/cbe9e4eb-3b67-3d77-bde8-9a8275c07620","info":{"contact":{"email":"hyperfabric-support@cisco.com","name":"Cisco Nexus Hyperfabric REST API","url":"https://hyperfabric.cisco.com"},"description":"Use this documentation to explore the API in detail.\n\nEach request will have a complete description of all the accepted parameters.\n\n## Authentication\n\nRequests are authenticated using Bearer Tokens. Tokens should be created from within the Hyperfabric service web UI and stored securely.\n\nSee the [bearer token](https://developer.cisco.com/docs/hyperfabric/authentication/#bearer-tokens) documentation page for more details.\n","license":{"name":"Cisco Licensing","url":"https://www.cisco.com/c/dam/en_us/about/doing_business/legal/Cisco_General_Terms.pdf"},"termsOfService":"https://www.cisco.com/c/dam/en_us/about/doing_business/legal/Cisco_General_Terms.pdf","title":"Cisco Nexus Hyperfabric REST API","version":"1.2.0-Rev.2026-02-17.c08d0"},"security":[{"http":[]}],"tags":[{"description":"APIs for managing authorization, account, users, API keys and tokens.","name":"Auth"},{"description":"APIs for managing devices.","name":"Devices"},{"description":"APIs for managing fabrics, candidate configurations and fabric connections.","name":"Fabrics"},{"description":"APIs for monitoring fabrics.","name":"Monitor"},{"description":"APIs for network configuration.","name":"Networks"},{"description":"APIs for managing nodes, ports, port channels and other interfaces.","name":"Nodes"},{"description":"APIs for managing port channels on a fabric.","name":"Port Channels"},{"description":"APIs for managing VNIs","name":"Vnis"},{"description":"APIs for managing VRFs.","name":"Vrfs"}],"openapi":"3.0.3","servers":[{"description":"V1 Server","url":"https://hyperfabric.cisco.com/api/v1"}],"securitySchemes":{"http":{"bearerFormat":"JWT","description":"A bearer token issued by the service","scheme":"bearer","type":"http"}}},"spec":{"description":"A Device is a physical device such as a Cisco 6000 switch managed by Cisco Nexus Hyperfabric that can be bound to a node in a fabric.","nullable":true,"properties":{"claimedAt":{"description":"This is a read-only field. The timestamp at which the device was claimed.","format":"date-time","readOnly":true,"type":"string"},"deviceId":{"description":"This is a read-only field. The device identifier of the device.","readOnly":true,"type":"string"},"fabricId":{"description":"This is a read-only field. The unique identifier of the fabric of the node to which the device is bound.","readOnly":true,"type":"string"},"fabricName":{"description":"This is a read-only field. The name of the fabric that the devices belongs to.","readOnly":true,"type":"string"},"modelName":{"description":"This is a read-only field. The model name of the device.","readOnly":true,"type":"string"},"name":{"description":"This is a read-only field. The name of the device.","readOnly":true,"type":"string"},"nodeId":{"description":"This is a read-only field. The unique identifier of the node to which the device is bound.","readOnly":true,"type":"string"},"nodeType":{"default":"NODE_BLUEPRINT","description":"NodeType defines an enumeration of node types.","enum":["NODE_BLUEPRINT","NODE_SWITCH","NODE_SERVER"],"type":"string","$$ref":"#/components/schemas/modelsNodeType"},"roles":{"description":"This is a read-only field. A list of roles associated with the node to which the device is bound.","items":{"default":"LEAF","description":"NodeRole defines an enumeration of roles that can be associated with a node.","enum":["LEAF","SPINE","SERVER","BORDER"],"type":"string","$$ref":"#/components/schemas/modelsNodeRole"},"readOnly":true,"type":"array"},"serialNumber":{"description":"This is a read-only field. The serial number of the device.","readOnly":true,"type":"string"}},"type":"object","$$ref":"#/components/schemas/miscDevice","title":"miscDevice"}}