Spectro Cloud Metrics API

The metrics API from Spectro Cloud — 2 operation(s) for metrics.

Operations 3

GET /v1/metrics/{resourceKind}/values Retrieves the list of metrics for a specified resource kind #
DELETE /v1/metrics/{resourceKind}/{resourceUid}/values Deletes the metrics of the specified resource #
GET /v1/metrics/{resourceKind}/{resourceUid}/values Returns the metrics for a specified resource uid #

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:spectro-cloud-metrics-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.

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

OpenAPI Specification

spectro-cloud-metrics-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Spectro Cloud Metrics API
  version: v1
  description: 'Operations tagged metrics across 2 of this provider''s published API definitions: spectro-cloud-palette-openapi.json, spectrocloud-palette.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.spectrocloud.com
- url: /
tags:
- name: Metrics
  x-displayName: Metrics
paths:
  /v1/metrics/{resourceKind}/values:
    get:
      description: Returns all the metrics for a given resource kind
      operationId: v1MetricsList
      parameters:
      - in: path
        name: resourceKind
        required: true
        schema:
          type: string
          enum:
          - pod
          - namespace
          - spectrocluster
          - machine
          - project
      - in: query
        name: metricKind
        schema:
          type: string
          default: all
      - description: Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON.  Wrappers are provided for many of the factory methods that the time package offers.
        in: query
        name: startTime
        schema:
          type: string
          format: date-time
      - description: Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON.  Wrappers are provided for many of the factory methods that the time package offers.
        in: query
        name: endTime
        schema:
          type: string
          format: date-time
      - in: query
        name: period
        schema:
          type: integer
          format: int32
          default: 1
      - description: Deprecated. includeMasterMachines in boolean, group the data point by including control plane nodes if set to true
        in: query
        name: includeMasterMachines
        schema:
          type: boolean
          default: false
      - description: includeControlPlaneMachines in boolean, group the data point by including control plane nodes if set to true
        in: query
        name: includeControlPlaneMachines
        schema:
          type: boolean
          default: false
      - description: if true then api returns only aggregation values, else api returns all data points by default
        in: query
        name: discrete
        schema:
          type: boolean
          default: false
      - in: query
        name: spectroClusterUid
        schema:
          type: string
      - description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
        in: header
        name: ProjectUid
        schema:
          type: string
      responses:
        '200':
          description: An array of metric items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1MetricTimeSeriesList'
      security:
      - ApiKey: []
      - Authorization: []
      summary: Retrieves the list of metrics for a specified resource kind
      tags:
      - Metrics
    servers:
    - url: https://api.spectrocloud.com
  /v1/metrics/{resourceKind}/{resourceUid}/values:
    delete:
      operationId: v1MetricsUidDelete
      parameters:
      - in: path
        name: resourceKind
        required: true
        schema:
          type: string
          enum:
          - pod
          - namespace
          - spectrocluster
          - machine
          - project
      - in: path
        name: resourceUid
        required: true
        schema:
          type: string
      - description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
        in: header
        name: ProjectUid
        schema:
          type: string
      responses:
        '204':
          description: The resource was deleted successfully
      security:
      - ApiKey: []
      - Authorization: []
      summary: Deletes the metrics of the specified resource
      tags:
      - Metrics
    get:
      operationId: v1MetricsUidList
      parameters:
      - in: path
        name: resourceKind
        required: true
        schema:
          type: string
          enum:
          - pod
          - namespace
          - spectrocluster
          - machine
          - project
      - in: path
        name: resourceUid
        required: true
        schema:
          type: string
      - description: multiple metric kinds can be provided with comma separated
        in: query
        name: metricKind
        schema:
          type: string
          default: all
      - description: Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON.  Wrappers are provided for many of the factory methods that the time package offers.
        in: query
        name: startTime
        schema:
          type: string
          format: date-time
      - description: Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON.  Wrappers are provided for many of the factory methods that the time package offers.
        in: query
        name: endTime
        schema:
          type: string
          format: date-time
      - description: period in minutes, group the data point by the specified period
        in: query
        name: period
        schema:
          type: integer
          format: int32
          default: 1
      - description: Deprecated. includeMasterMachines in boolean, group the data point by including control plane nodes if set to true
        in: query
        name: includeMasterMachines
        schema:
          type: boolean
          default: false
      - description: includeControlPlaneMachines in boolean, group the data point by including control plane nodes if set to true
        in: query
        name: includeControlPlaneMachines
        schema:
          type: boolean
          default: false
      - description: if true then api returns only aggregation values, else api returns all data points by default
        in: query
        name: discrete
        schema:
          type: boolean
          default: false
      - description: A project UID is required for project-scoped resources and should be omitted when targeting tenant-scoped resources
        in: header
        name: ProjectUid
        schema:
          type: string
      responses:
        '200':
          description: An array of metric items
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1MetricTimeSeries'
      security:
      - ApiKey: []
      - Authorization: []
      summary: Returns the metrics for a specified resource uid
      tags:
      - Metrics
    servers:
    - url: https://api.spectrocloud.com
components:
  schemas:
    v1MetricsList:
      properties:
        metadata:
          $ref: '#/components/schemas/v1MetricMetadata'
        metrics:
          items:
            $ref: '#/components/schemas/v1Metrics'
          type: array
          uniqueItems: true
      type: object
    v1MetricTimeSeries:
      properties:
        items:
          items:
            $ref: '#/components/schemas/v1Metrics'
          type: array
          uniqueItems: true
      required:
      - items
      type: object
    v1MetricAggregation:
      description: Aggregation values
      properties:
        avg:
          type: number
          x-omitempty: false
        count:
          format: int64
          type: number
          x-omitempty: false
        max:
          type: number
          x-omitempty: false
        min:
          type: number
          x-omitempty: false
        sum:
          type: number
          x-omitempty: false
      type: object
    v1MetricPoint:
      description: Metric Info
      properties:
        avg:
          type: number
        count:
          format: int64
          type: number
        max:
          type: number
        min:
          type: number
        sum:
          type: number
        timestamp:
          format: int64
          type: number
        value:
          type: number
          x-omitempty: false
      type: object
    v1MetricMetadata:
      properties:
        name:
          type: string
        uid:
          type: string
      type: object
    v1MetricTimeSeriesList:
      properties:
        items:
          items:
            $ref: '#/components/schemas/v1MetricsList'
          type: array
          uniqueItems: true
      required:
      - items
      type: object
    v1Metrics:
      properties:
        aggregation:
          $ref: '#/components/schemas/v1MetricAggregation'
        kind:
          type: string
        points:
          items:
            $ref: '#/components/schemas/v1MetricPoint'
          type: array
          uniqueItems: true
        unit:
          type: string
      type: object
    v1MetricsList_2:
      example:
        metadata:
          uid: uid
          name: name
        metrics:
        - unit: unit
          kind: kind
          aggregation:
            avg: 0.8008281904610115
            min: 5.962133916683182
            max: 1.4658129805029452
            count: 6.027456183070403
            sum: 5.637376656633329
          points:
          - avg: 2.3021358869347655
            min: 3.616076749251911
            max: 9.301444243932576
            count: 7.061401241503109
            sum: 2.027123023002322
            value: 7.386281948385884
            timestamp: 4.145608029883936
          - avg: 2.3021358869347655
            min: 3.616076749251911
            max: 9.301444243932576
            count: 7.061401241503109
            sum: 2.027123023002322
            value: 7.386281948385884
            timestamp: 4.145608029883936
        - unit: unit
          kind: kind
          aggregation:
            avg: 0.8008281904610115
            min: 5.962133916683182
            max: 1.4658129805029452
            count: 6.027456183070403
            sum: 5.637376656633329
          points:
          - avg: 2.3021358869347655
            min: 3.616076749251911
            max: 9.301444243932576
            count: 7.061401241503109
            sum: 2.027123023002322
            value: 7.386281948385884
            timestamp: 4.145608029883936
          - avg: 2.3021358869347655
            min: 3.616076749251911
            max: 9.301444243932576
            count: 7.061401241503109
            sum: 2.027123023002322
            value: 7.386281948385884
            timestamp: 4.145608029883936
      properties:
        metadata:
          $ref: '#/components/schemas/v1MetricMetadata_2'
        metrics:
          items:
            $ref: '#/components/schemas/v1Metrics_2'
          type: array
          uniqueItems: true
      type: object
    v1MetricTimeSeries_2:
      example:
        items:
        - unit: unit
          kind: kind
          aggregation:
            avg: 0.8008281904610115
            min: 5.962133916683182
            max: 1.4658129805029452
            count: 6.027456183070403
            sum: 5.637376656633329
          points:
          - avg: 2.3021358869347655
            min: 3.616076749251911
            max: 9.301444243932576
            count: 7.061401241503109
            sum: 2.027123023002322
            value: 7.386281948385884
            timestamp: 4.145608029883936
          - avg: 2.3021358869347655
            min: 3.616076749251911
            max: 9.301444243932576
            count: 7.061401241503109
            sum: 2.027123023002322
            value: 7.386281948385884
            timestamp: 4.145608029883936
        - unit: unit
          kind: kind
          aggregation:
            avg: 0.8008281904610115
            min: 5.962133916683182
            max: 1.4658129805029452
            count: 6.027456183070403
            sum: 5.637376656633329
          points:
          - avg: 2.3021358869347655
            min: 3.616076749251911
            max: 9.301444243932576
            count: 7.061401241503109
            sum: 2.027123023002322
            value: 7.386281948385884
            timestamp: 4.145608029883936
          - avg: 2.3021358869347655
            min: 3.616076749251911
            max: 9.301444243932576
            count: 7.061401241503109
            sum: 2.027123023002322
            value: 7.386281948385884
            timestamp: 4.145608029883936
      properties:
        items:
          items:
            $ref: '#/components/schemas/v1Metrics_2'
          type: array
          uniqueItems: true
      required:
      - items
      type: object
    v1MetricAggregation_2:
      description: Aggregation values
      example:
        avg: 0.8008281904610115
        min: 5.962133916683182
        max: 1.4658129805029452
        count: 6.027456183070403
        sum: 5.637376656633329
      properties:
        avg:
          type: number
          x-omitempty: false
        count:
          format: int64
          type: number
          x-omitempty: false
        max:
          type: number
          x-omitempty: false
        min:
          type: number
          x-omitempty: false
        sum:
          type: number
          x-omitempty: false
      type: object
    v1MetricPoint_2:
      description: Metric Info
      example:
        avg: 2.3021358869347655
        min: 3.616076749251911
        max: 9.301444243932576
        count: 7.061401241503109
        sum: 2.027123023002322
        value: 7.386281948385884
        timestamp: 4.145608029883936
      properties:
        avg:
          type: number
        count:
          format: int64
          type: number
        max:
          type: number
        min:
          type: number
        sum:
          type: number
        timestamp:
          format: int64
          type: number
        value:
          type: number
          x-omitempty: false
      type: object
    v1MetricMetadata_2:
      example:
        uid: uid
        name: name
      properties:
        name:
          type: string
        uid:
          type: string
      type: object
    v1MetricTimeSeriesList_2:
      example:
        items:
        - metadata:
            uid: uid
            name: name
          metrics:
          - unit: unit
            kind: kind
            aggregation:
              avg: 0.8008281904610115
              min: 5.962133916683182
              max: 1.4658129805029452
              count: 6.027456183070403
              sum: 5.637376656633329
            points:
            - avg: 2.3021358869347655
              min: 3.616076749251911
              max: 9.301444243932576
              count: 7.061401241503109
              sum: 2.027123023002322
              value: 7.386281948385884
              timestamp: 4.145608029883936
            - avg: 2.3021358869347655
              min: 3.616076749251911
              max: 9.301444243932576
              count: 7.061401241503109
              sum: 2.027123023002322
              value: 7.386281948385884
              timestamp: 4.145608029883936
          - unit: unit
            kind: kind
            aggregation:
              avg: 0.8008281904610115
              min: 5.962133916683182
              max: 1.4658129805029452
              count: 6.027456183070403
              sum: 5.637376656633329
            points:
            - avg: 2.3021358869347655
              min: 3.616076749251911
              max: 9.301444243932576
              count: 7.061401241503109
              sum: 2.027123023002322
              value: 7.386281948385884
              timestamp: 4.145608029883936
            - avg: 2.3021358869347655
              min: 3.616076749251911
              max: 9.301444243932576
              count: 7.061401241503109
              sum: 2.027123023002322
              value: 7.386281948385884
              timestamp: 4.145608029883936
        - metadata:
            uid: uid
            name: name
          metrics:
          - unit: unit
            kind: kind
            aggregation:
              avg: 0.8008281904610115
              min: 5.962133916683182
              max: 1.4658129805029452
              count: 6.027456183070403
              sum: 5.637376656633329
            points:
            - avg: 2.3021358869347655
              min: 3.616076749251911
              max: 9.301444243932576
              count: 7.061401241503109
              sum: 2.027123023002322
              value: 7.386281948385884
              timestamp: 4.145608029883936
            - avg: 2.3021358869347655
              min: 3.616076749251911
              max: 9.301444243932576
              count: 7.061401241503109
              sum: 2.027123023002322
              value: 7.386281948385884
              timestamp: 4.145608029883936
          - unit: unit
            kind: kind
            aggregation:
              avg: 0.8008281904610115
              min: 5.962133916683182
              max: 1.4658129805029452
              count: 6.027456183070403
              sum: 5.637376656633329
            points:
            - avg: 2.3021358869347655
              min: 3.616076749251911
              max: 9.301444243932576
              count: 7.061401241503109
              sum: 2.027123023002322
              value: 7.386281948385884
              timestamp: 4.145608029883936
            - avg: 2.3021358869347655
              min: 3.616076749251911
              max: 9.301444243932576
              count: 7.061401241503109
              sum: 2.027123023002322
              value: 7.386281948385884
              timestamp: 4.145608029883936
      properties:
        items:
          items:
            $ref: '#/components/schemas/v1MetricsList_2'
          type: array
          uniqueItems: true
      required:
      - items
      type: object
    v1Metrics_2:
      example:
        unit: unit
        kind: kind
        aggregation:
          avg: 0.8008281904610115
          min: 5.962133916683182
          max: 1.4658129805029452
          count: 6.027456183070403
          sum: 5.637376656633329
        points:
        - avg: 2.3021358869347655
          min: 3.616076749251911
          max: 9.301444243932576
          count: 7.061401241503109
          sum: 2.027123023002322
          value: 7.386281948385884
          timestamp: 4.145608029883936
        - avg: 2.3021358869347655
          min: 3.616076749251911
          max: 9.301444243932576
          count: 7.061401241503109
          sum: 2.027123023002322
          value: 7.386281948385884
          timestamp: 4.145608029883936
      properties:
        aggregation:
          $ref: '#/components/schemas/v1MetricAggregation_2'
        kind:
          type: string
        points:
          items:
            $ref: '#/components/schemas/v1MetricPoint_2'
          type: array
          uniqueItems: true
        unit:
          type: string
      type: object
  securitySchemes:
    ApiKey:
      description: API key authorization where API key can be generated from Palette console under Profile > My API Keys
      in: header
      name: ApiKey
      type: apiKey
    Authorization:
      description: JWT token authorization obtained using /v1/auth/authenticate api
      in: header
      name: Authorization
      type: apiKey
x-refined-from:
- spectro-cloud-palette-openapi.json
- spectrocloud-palette.yaml