Spectro Cloud

Spectro Cloud edge-mgmt API

The edge-mgmt API from Spectro Cloud — 64 operation(s) for edge-mgmt.

GitHub OpenAPI

Operations 84

GET /v1/edge-mgmt/cluster Get the details of the cluster. #
POST /v1/edge-mgmt/cluster Creates a cluster with the provided cluster configuration #
DELETE /v1/edge-mgmt/cluster Delete a cluster #
PATCH /v1/edge-mgmt/cluster DEPRECATED - This endpoint is deprecated and will be removed in future versions. Use /v1/edge-mgmt/cluster/{clusterName} instead #
GET /v1/edge-mgmt/cluster/applications list the details of the cluster’s packs. #
GET /v1/edge-mgmt/cluster/certificates Get Cluster Certificates Info #
GET /v1/edge-mgmt/cluster/details Get Edge Cluster details #
GET /v1/edge-mgmt/cluster/events List cluster events #
POST /v1/edge-mgmt/cluster/pair Creates a pairing request #
GET /v1/edge-mgmt/cluster/pair/details Get all existing pairing requests #
POST /v1/edge-mgmt/cluster/pair/reject Rejects a pairing request #
POST /v1/edge-mgmt/cluster/pair/verify-connection Verifies whether all cluster hosts are able to connect to palette #
PUT /v1/edge-mgmt/cluster/profiles Updates a cluster with the provided cluster configuration #
POST /v1/edge-mgmt/cluster/profiles/variables/validate Validate cluster profile variables #
GET /v1/edge-mgmt/cluster/registry/content/details List existing Harbor Content Details #
GET /v1/edge-mgmt/cluster/registry/content/sync-status/details List Harbor Content Sync Status #
GET /v1/edge-mgmt/cluster/registry/health Gets the harbor health status #
POST /v1/edge-mgmt/cluster/renew-certificates Renew Cluster Certificates #
PUT /v1/edge-mgmt/cluster/settings Update cluster settings #
PUT /v1/edge-mgmt/cluster/{clusterName} Updates a cluster with the provided cluster configuration #
PATCH /v1/edge-mgmt/cluster/{clusterName} Patch a cluster with the provided cluster configuration #
GET /v1/edge-mgmt/clusters/archive/embedded/details parses the preloaded cluster-config archive if it was included in the ISO. #
GET /v1/edge-mgmt/clusters/archive/overridden/details parses the cluster-config archive if it exists. #
DELETE /v1/edge-mgmt/clusters/archive/update Delete or reject the cluster update archive #
GET /v1/edge-mgmt/clusters/archive/update/details parses the cluster-config update archive if it was included in the uploaded content-bundle. #
GET /v1/edge-mgmt/clusters/current/machinepools Fetch the cluster node pool details including edge host details. #
POST /v1/edge-mgmt/clusters/current/machinepools Create a machine pool #
PUT /v1/edge-mgmt/clusters/current/machinepools/{poolName} Update machine pools #
DELETE /v1/edge-mgmt/clusters/current/machinepools/{poolName} Delete machine pools #
PATCH /v1/edge-mgmt/clusters/current/machinepools/{poolName} Patch machine pools #
DELETE /v1/edge-mgmt/clusters/current/machinepools/{poolName}/nodes/{nodeName} Delete a machine pool node #
GET /v1/edge-mgmt/clusters/current/nodes A list of the K8s Cluster Nodes #
GET /v1/edge-mgmt/edgehosts/connectivity/ping Ping an endpoint #
GET /v1/edge-mgmt/edgehosts/connectivity/traceroute Display route that IP packets take to a network host #
GET /v1/edge-mgmt/edgehosts/current Get edge host info #
GET /v1/edge-mgmt/edgehosts/current/actions/content/signing-public-key Get the public key used to verify the signed content. #
POST /v1/edge-mgmt/edgehosts/current/actions/reboot Reboot edge host #
POST /v1/edge-mgmt/edgehosts/current/actions/reset Reset edge host #
POST /v1/edge-mgmt/edgehosts/current/actions/shutdown Shutdown edge host #
POST /v1/edge-mgmt/edgehosts/current/actions/upload-clusterconfig Uploads the cluster config archive and extracts it to the required location on the edge host. #
POST /v1/edge-mgmt/edgehosts/current/actions/upload-content Uploads an archive file and extracts it to the required location on the edge host. #
GET /v1/edge-mgmt/edgehosts/current/audits Retrieves the list of audit logs #
GET /v1/edge-mgmt/edgehosts/current/audits/download Download audit logs #
GET /v1/edge-mgmt/edgehosts/current/audits/filters Retrieves the list of filter options to display on audit ui page #
GET /v1/edge-mgmt/edgehosts/current/configurations Get edge host configurations. #
PUT /v1/edge-mgmt/edgehosts/current/configurations Update Edge Host configurations #
GET /v1/edge-mgmt/edgehosts/current/configurations/status Edge host configurations status #
GET /v1/edge-mgmt/edgehosts/current/download-logs Download edge host Logs #
GET /v1/edge-mgmt/edgehosts/current/error-logs List last 'logCount' edge host error logs #
GET /v1/edge-mgmt/edgehosts/current/file-download/files List custom files from the '/var/log/files' directory #
GET /v1/edge-mgmt/edgehosts/current/file-download/{filePath} Download a custom file from the user-defined or default directory #
POST /v1/edge-mgmt/edgehosts/current/generate-logs Start edge host log collection #
GET /v1/edge-mgmt/edgehosts/current/generate-logs-status Edge host log collection status #
POST /v1/edge-mgmt/edgehosts/current/link/generate-token Generate a link token for linking edge hosts #
GET /v1/edge-mgmt/edgehosts/current/link/status Get the status of the edge host link #
GET /v1/edge-mgmt/edgehosts/current/uploaded-content/details Get metadata of last uploaded content archive file #
GET /v1/edge-mgmt/edgehosts/current/userdata Get edge host userdata #
PUT /v1/edge-mgmt/edgehosts/current/userdata Update edge host userdata #
POST /v1/edge-mgmt/edgehosts/current/userdata Update edge host userdata #
GET /v1/edge-mgmt/events/lifecycle Get life cycle events of cluster and edge host #
GET /v1/edge-mgmt/network/bonds List bonds #
GET /v1/edge-mgmt/network/bonds/{name} Get bond #
PUT /v1/edge-mgmt/network/bonds/{name} Create or update bond #
POST /v1/edge-mgmt/network/bonds/{name} Create bond #
DELETE /v1/edge-mgmt/network/bonds/{name} Delete bond #
GET /v1/edge-mgmt/network/bridges List bridges #
GET /v1/edge-mgmt/network/bridges/{name} Get bridge #
PUT /v1/edge-mgmt/network/bridges/{name} Create or update bridge #
POST /v1/edge-mgmt/network/bridges/{name} Create bridge #
DELETE /v1/edge-mgmt/network/bridges/{name} Delete bridge #
GET /v1/edge-mgmt/network/config-options Get network config options #
GET /v1/edge-mgmt/network/interfaces List NICs #
GET /v1/edge-mgmt/network/interfaces/{name} Get NIC #
PUT /v1/edge-mgmt/network/interfaces/{name}/config Update NIC config #
GET /v1/edge-mgmt/network/management-interface Get the currently selected management interface and the candidate list #
PUT /v1/edge-mgmt/network/management-interface Set the management interface #
GET /v1/edge-mgmt/network/vlans List VLANs #
GET /v1/edge-mgmt/network/vlans/{name} Get VLAN #
PUT /v1/edge-mgmt/network/vlans/{name} Create or update VLAN #
POST /v1/edge-mgmt/network/vlans/{name} Create VLAN #
DELETE /v1/edge-mgmt/network/vlans/{name} Delete VLAN #
GET /v1/edge-mgmt/settings Get general settings #

Documentation

📖
Documentation
https://docs.spectrocloud.com/api/introduction/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/spectro-cloud/refs/heads/main/openapi/spectro-cloud-edge-mgmt-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/spectro-cloud-edge-mgmt-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

spectro-cloud-edge-mgmt-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Local Management APIs activations Edge Mgmt API
  version: v1
servers:
- url: https://edge-host-ip:5080
tags:
- name: edge-mgmt
  x-displayName: Edge Mgmt
paths:
  /v1/edge-mgmt/cluster:
    get:
      description: Get the details of the cluster.
      tags:
      - edge-mgmt
      summary: Get the details of the cluster.
      operationId: v1ClusterConfig
      responses:
        '200':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ClusterConfiguration'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        default:
          description: generic error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
      security:
      - Authorization: []
    post:
      description: Creates a cluster with the provided cluster configuration
      tags:
      - edge-mgmt
      summary: Creates a cluster with the provided cluster configuration
      operationId: v1CreateCluster
      responses:
        '202':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ClusterConfiguration'
        required: true
    delete:
      description: Delete a cluster
      tags:
      - edge-mgmt
      summary: Delete a cluster
      operationId: v1DeleteCluster
      responses:
        '202':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
    patch:
      description: DEPRECATED - This endpoint is deprecated and will be removed in future versions. Use /v1/edge-mgmt/cluster/{clusterName} instead
      tags:
      - edge-mgmt
      summary: DEPRECATED - This endpoint is deprecated and will be removed in future versions. Use /v1/edge-mgmt/cluster/{clusterName} instead
      operationId: v1PatchCluster
      deprecated: true
      responses:
        '202':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ClusterConfiguration'
        required: true
  /v1/edge-mgmt/cluster/applications:
    get:
      description: list the details of the cluster’s packs.
      tags:
      - edge-mgmt
      summary: list the details of the cluster’s packs.
      operationId: v1ClusterApplications
      responses:
        '200':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ClusterCurrentApplications'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        default:
          description: generic error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
      security:
      - Authorization: []
  /v1/edge-mgmt/cluster/certificates:
    get:
      description: Get Cluster Certificates Info
      tags:
      - edge-mgmt
      summary: Get Cluster Certificates Info
      operationId: v1CertificateDetails
      responses:
        '200':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1CertificateDetails'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
  /v1/edge-mgmt/cluster/details:
    get:
      description: Get Edge Cluster details
      tags:
      - edge-mgmt
      summary: Get Edge Cluster details
      operationId: v1ClusterGet
      responses:
        '200':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Cluster'
        '404':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1NotFound'
        '500':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
  /v1/edge-mgmt/cluster/events:
    get:
      description: List cluster events
      tags:
      - edge-mgmt
      summary: List cluster events
      operationId: v1GetClusterEvents
      parameters:
      - name: namespace
        in: query
        schema:
          type: string
      responses:
        '200':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Events'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        default:
          description: generic error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
      security:
      - Authorization: []
  /v1/edge-mgmt/cluster/pair:
    post:
      tags:
      - edge-mgmt
      summary: Creates a pairing request
      operationId: v1ClusterPair
      responses:
        '201':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ClusterPairInfoResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ClusterPairMeta'
        required: true
  /v1/edge-mgmt/cluster/pair/details:
    get:
      tags:
      - edge-mgmt
      summary: Get all existing pairing requests
      operationId: v1ClusterPairDetails
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ClusterPairDetailsResponse'
        '404':
          description: Not found error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
  /v1/edge-mgmt/cluster/pair/reject:
    post:
      tags:
      - edge-mgmt
      summary: Rejects a pairing request
      operationId: v1ClusterPairReject
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '404':
          description: Not found error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
  /v1/edge-mgmt/cluster/pair/verify-connection:
    post:
      tags:
      - edge-mgmt
      summary: Verifies whether all cluster hosts are able to connect to palette
      operationId: v1ClusterPairVerifyConnection
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ClusterPairVerifiedConnectionResponse'
        '400':
          description: Invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1BadRequest'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ClusterPairMeta'
        required: true
  /v1/edge-mgmt/cluster/profiles:
    put:
      description: Updates a cluster with the provided cluster configuration
      tags:
      - edge-mgmt
      summary: Updates a cluster with the provided cluster configuration
      operationId: v1UpdateClusterProfiles
      responses:
        '202':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ClusterProfileConfiguration'
        required: true
  /v1/edge-mgmt/cluster/profiles/variables/validate:
    post:
      description: Validate cluster profile variables
      tags:
      - edge-mgmt
      summary: Validate cluster profile variables
      operationId: v1ValidateClusterProfileVariables
      responses:
        '200':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ValidateVariablesResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ValidateVariables'
        required: true
  /v1/edge-mgmt/cluster/registry/content/details:
    get:
      description: Get Harbor Content Details
      tags:
      - edge-mgmt
      summary: List existing Harbor Content Details
      operationId: v1HarborContentsDetails
      responses:
        '200':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1HarborContentsDetails'
      security:
      - Authorization: []
  /v1/edge-mgmt/cluster/registry/content/sync-status/details:
    get:
      description: Get Harbor Content Sync Status
      tags:
      - edge-mgmt
      summary: List Harbor Content Sync Status
      operationId: v1HarborContentsSyncStatusDetails
      responses:
        '200':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1HarborContentsSyncStatus'
      security:
      - Authorization: []
  /v1/edge-mgmt/cluster/registry/health:
    get:
      description: Gets the harbor health status
      tags:
      - edge-mgmt
      summary: Gets the harbor health status
      operationId: V1HarborHealth
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1HarborHealthDetails'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
      security:
      - Authorization: []
  /v1/edge-mgmt/cluster/renew-certificates:
    post:
      description: Renew Cluster Certificates
      tags:
      - edge-mgmt
      summary: Renew Cluster Certificates
      operationId: v1RenewCerts
      responses:
        '201':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
  /v1/edge-mgmt/cluster/settings:
    put:
      description: Update cluster settings
      tags:
      - edge-mgmt
      summary: Update cluster settings
      operationId: v1EdgeNativeClusterSettings
      responses:
        '202':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        default:
          description: generic error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
      security:
      - Authorization: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1EdgeNativeClusterSettings'
        required: true
  /v1/edge-mgmt/cluster/{clusterName}:
    put:
      description: Updates a cluster with the provided cluster configuration
      tags:
      - edge-mgmt
      summary: Updates a cluster with the provided cluster configuration
      operationId: v1UpdateClusterConfig
      parameters:
      - description: Name of the cluster to be updated
        name: clusterName
        in: path
        required: true
        schema:
          type: string
      responses:
        '202':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ClusterConfiguration'
        required: true
    patch:
      description: Patch a cluster with the provided cluster configuration
      tags:
      - edge-mgmt
      summary: Patch a cluster with the provided cluster configuration
      operationId: v1PatchClusterConfig
      parameters:
      - description: Name of the cluster to be patched
        name: clusterName
        in: path
        required: true
        schema:
          type: string
      responses:
        '202':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ClusterPatch'
        required: true
  /v1/edge-mgmt/clusters/archive/embedded/details:
    get:
      description: parses the cluster-config archive.
      tags:
      - edge-mgmt
      summary: parses the preloaded cluster-config archive if it was included in the ISO.
      operationId: V1ClusterConfigArchiveEmbedded
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ClusterConfigArchiveDetails'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
  /v1/edge-mgmt/clusters/archive/overridden/details:
    get:
      description: parses the cluster-config archive if it was uploaded as a standalone configuration.
      tags:
      - edge-mgmt
      summary: parses the cluster-config archive if it exists.
      operationId: v1ClusterConfigArchiveOverriden
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ClusterConfigArchiveDetails'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
  /v1/edge-mgmt/clusters/archive/update:
    delete:
      description: Delete or reject the cluster update archive
      tags:
      - edge-mgmt
      summary: Delete or reject the cluster update archive
      operationId: v1DeleteClusterUpdateArchive
      responses:
        '202':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
  /v1/edge-mgmt/clusters/archive/update/details:
    get:
      description: parses the cluster-config update archive if it was included in the uploaded content-bundle.
      tags:
      - edge-mgmt
      summary: parses the cluster-config update archive if it was included in the uploaded content-bundle.
      operationId: v1ClusterConfigArchiveUpdate
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ClusterConfigArchiveDetails'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
  /v1/edge-mgmt/clusters/current/machinepools:
    get:
      tags:
      - edge-mgmt
      summary: Fetch the cluster node pool details including edge host details.
      operationId: v1MachinePoolDetail
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/v1EdgeNativeMachinePoolConfig'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
    post:
      tags:
      - edge-mgmt
      summary: Create a machine pool
      operationId: v1ClusterMachinePoolCreate
      responses:
        '201':
          description: machine pool created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '400':
          description: Bad request, invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1EdgeNativeMachinePoolConfig'
        required: true
  /v1/edge-mgmt/clusters/current/machinepools/{poolName}:
    put:
      tags:
      - edge-mgmt
      summary: Update machine pools
      operationId: v1ClusterMachinePoolUpdate
      parameters:
      - description: Name of the machine pool to be updated
        name: poolName
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: machine pool configurations updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '400':
          description: Bad request, invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1EdgeNativeMachinePoolConfig'
        required: true
    delete:
      tags:
      - edge-mgmt
      summary: Delete machine pools
      operationId: v1ClusterMachinePoolDelete
      parameters:
      - description: Name of the machine pool to be deleted
        name: poolName
        in: path
        required: true
        schema:
          type: string
      responses:
        '202':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
    patch:
      tags:
      - edge-mgmt
      summary: Patch machine pools
      operationId: v1ClusterMachinePoolPatch
      parameters:
      - description: Name of the machine pool to be patched
        name: poolName
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: machine pool configurations patched
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '400':
          description: Bad request, invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1MachinePoolPatch'
        required: true
  /v1/edge-mgmt/clusters/current/machinepools/{poolName}/nodes/{nodeName}:
    delete:
      description: Delete a node from the machine pool
      tags:
      - edge-mgmt
      summary: Delete a machine pool node
      operationId: v1ClusterMachinePoolNodeDelete
      parameters:
      - description: Name of the machine pool
        name: poolName
        in: path
        required: true
        schema:
          type: string
      - description: Name of the node
        name: nodeName
        in: path
        required: true
        schema:
          type: string
      responses:
        '202':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '400':
          description: Bad request, invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
  /v1/edge-mgmt/clusters/current/nodes:
    get:
      description: Get K8s Cluster Nodes
      tags:
      - edge-mgmt
      summary: A list of the K8s Cluster Nodes
      operationId: v1ClusterNodes
      responses:
        '200':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ClusterNodes'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
  /v1/edge-mgmt/edgehosts/connectivity/ping:
    get:
      description: Ping an endpoint
      tags:
      - edge-mgmt
      summary: Ping an endpoint
      operationId: v1PingHost
      parameters:
      - name: endpoint
        in: query
        schema:
          type: string
      responses:
        '200':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1PingResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
  /v1/edge-mgmt/edgehosts/connectivity/traceroute:
    get:
      description: Display route that IP packets take to a network host
      tags:
      - edge-mgmt
      summary: Display route that IP packets take to a network host
      operationId: v1TraceRouteHost
      parameters:
      - name: endpoint
        in: query
        schema:
          type: string
      responses:
        '200':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1TraceRouteResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
      security:
      - Authorization: []
  /v1/edge-mgmt/edgehosts/current:
    get:
      description: Get edge host details
      tags:
      - edge-mgmt
      summary: Get edge host info
      operationId: v1EdgeHostInfo
      responses:
        '200':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1EdgeHostInfo'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        default:
          description: generic error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
      security:
      - Authorization: []
  /v1/edge-mgmt/edgehosts/current/actions/content/signing-public-key:
    get:
      description: Get the base64 encoded key used to verify the signed content.
      tags:
      - edge-mgmt
      summary: Get the public key used to verify the signed content.
      operationId: V1GetContentSigningPublicKey
      responses:
        '200':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ContentSigningKey'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        default:
          description: generic error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
      security:
      - Authorization: []
  /v1/edge-mgmt/edgehosts/current/actions/reboot:
    post:
      description: Reboot edge host
      tags:
      - edge-mgmt
      summary: Reboot edge host
      operationId: v1EdgeHostActionReboot
      responses:
        '202':
          description: (empty)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        default:
          description: generic error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
      security:
      - Authorization: []
  /v1/edge-mgmt/edgehosts/current/actions/reset:
    post:
      description: Reset edge host
      tags:
      - edge-mgmt
      summary: Reset edge host
      operationId: v1EdgeHostActionReset
      responses:
        '202':
          description: Accepted response with message
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1AcceptedResponseWithMessage'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1Error'
        default:
          description: generic error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
      security:
      - Authorization: []
  /v1/edge

# --- truncated at 32 KB (142 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/spectro-cloud/refs/heads/main/openapi/spectro-cloud-edge-mgmt-api-openapi.yml