Render Public API — Metrics

naftiko: 1.0.0-alpha2
info:
  label: Render Public API — Metrics
  description: 'Render Public API — Metrics. 23 operations. Lead operation: Retrieve metrics stream. Self-contained Naftiko
    capability covering one Render business surface.'
  tags:
  - Render
  - Metrics
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    RENDER_API_KEY: RENDER_API_KEY
capability:
  consumes:
  - type: http
    namespace: render-metrics
    baseUri: https://api.render.com/v1
    description: Render Public API — Metrics business capability. Self-contained, no shared references.
    resources:
    - name: metrics-stream-ownerId
      path: /metrics-stream/{ownerId}
      operations:
      - name: getownermetricsstream
        method: GET
        description: Retrieve metrics stream
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: upsertownermetricsstream
        method: PUT
        description: Create or update metrics stream
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleteownermetricsstream
        method: DELETE
        description: Delete metrics stream
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-active-connections
      path: /metrics/active-connections
      operations:
      - name: getactiveconnections
        method: GET
        description: Get active connection count
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-bandwidth
      path: /metrics/bandwidth
      operations:
      - name: getbandwidth
        method: GET
        description: Get bandwidth usage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-bandwidth-sources
      path: /metrics/bandwidth-sources
      operations:
      - name: getbandwidthsources
        method: GET
        description: Get bandwidth usage breakdown by traffic source
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-cpu
      path: /metrics/cpu
      operations:
      - name: getcpu
        method: GET
        description: Get CPU usage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-cpu-limit
      path: /metrics/cpu-limit
      operations:
      - name: getcpulimit
        method: GET
        description: Get CPU limit
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-cpu-target
      path: /metrics/cpu-target
      operations:
      - name: getcputarget
        method: GET
        description: Get CPU target
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-disk-capacity
      path: /metrics/disk-capacity
      operations:
      - name: getdiskcapacity
        method: GET
        description: Get disk capacity
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-disk-usage
      path: /metrics/disk-usage
      operations:
      - name: getdiskusage
        method: GET
        description: Get disk usage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-filters-application
      path: /metrics/filters/application
      operations:
      - name: listapplicationfiltervalues
        method: GET
        description: List queryable instance values
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-filters-http
      path: /metrics/filters/http
      operations:
      - name: listhttpfiltervalues
        method: GET
        description: List queryable status codes and host values
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-filters-path
      path: /metrics/filters/path
      operations:
      - name: listpathfiltervalues
        method: GET
        description: List queryable paths
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-http-latency
      path: /metrics/http-latency
      operations:
      - name: gethttplatency
        method: GET
        description: Get HTTP latency
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-http-requests
      path: /metrics/http-requests
      operations:
      - name: gethttprequests
        method: GET
        description: Get HTTP request count
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-instance-count
      path: /metrics/instance-count
      operations:
      - name: getinstancecount
        method: GET
        description: Get instance count
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-memory
      path: /metrics/memory
      operations:
      - name: getmemory
        method: GET
        description: Get memory usage
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-memory-limit
      path: /metrics/memory-limit
      operations:
      - name: getmemorylimit
        method: GET
        description: Get memory limit
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-memory-target
      path: /metrics/memory-target
      operations:
      - name: getmemorytarget
        method: GET
        description: Get memory target
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-replication-lag
      path: /metrics/replication-lag
      operations:
      - name: getreplicationlag
        method: GET
        description: Get replica lag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-task-runs-completed
      path: /metrics/task-runs-completed
      operations:
      - name: gettaskrunscompleted
        method: GET
        description: Get task runs completed count
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-task-runs-queued
      path: /metrics/task-runs-queued
      operations:
      - name: gettaskrunsqueued
        method: GET
        description: Get task runs queued count
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.RENDER_API_KEY}}'
  exposes:
  - type: rest
    namespace: render-metrics-rest
    port: 8080
    description: REST adapter for Render Public API — Metrics. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/metrics-stream/{ownerid}
      name: metrics-stream-ownerid
      description: REST surface for metrics-stream-ownerId.
      operations:
      - method: GET
        name: getownermetricsstream
        description: Retrieve metrics stream
        call: render-metrics.getownermetricsstream
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: upsertownermetricsstream
        description: Create or update metrics stream
        call: render-metrics.upsertownermetricsstream
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteownermetricsstream
        description: Delete metrics stream
        call: render-metrics.deleteownermetricsstream
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/active-connections
      name: metrics-active-connections
      description: REST surface for metrics-active-connections.
      operations:
      - method: GET
        name: getactiveconnections
        description: Get active connection count
        call: render-metrics.getactiveconnections
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/bandwidth
      name: metrics-bandwidth
      description: REST surface for metrics-bandwidth.
      operations:
      - method: GET
        name: getbandwidth
        description: Get bandwidth usage
        call: render-metrics.getbandwidth
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/bandwidth-sources
      name: metrics-bandwidth-sources
      description: REST surface for metrics-bandwidth-sources.
      operations:
      - method: GET
        name: getbandwidthsources
        description: Get bandwidth usage breakdown by traffic source
        call: render-metrics.getbandwidthsources
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/cpu
      name: metrics-cpu
      description: REST surface for metrics-cpu.
      operations:
      - method: GET
        name: getcpu
        description: Get CPU usage
        call: render-metrics.getcpu
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/cpu-limit
      name: metrics-cpu-limit
      description: REST surface for metrics-cpu-limit.
      operations:
      - method: GET
        name: getcpulimit
        description: Get CPU limit
        call: render-metrics.getcpulimit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/cpu-target
      name: metrics-cpu-target
      description: REST surface for metrics-cpu-target.
      operations:
      - method: GET
        name: getcputarget
        description: Get CPU target
        call: render-metrics.getcputarget
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/disk-capacity
      name: metrics-disk-capacity
      description: REST surface for metrics-disk-capacity.
      operations:
      - method: GET
        name: getdiskcapacity
        description: Get disk capacity
        call: render-metrics.getdiskcapacity
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/disk-usage
      name: metrics-disk-usage
      description: REST surface for metrics-disk-usage.
      operations:
      - method: GET
        name: getdiskusage
        description: Get disk usage
        call: render-metrics.getdiskusage
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/filters/application
      name: metrics-filters-application
      description: REST surface for metrics-filters-application.
      operations:
      - method: GET
        name: listapplicationfiltervalues
        description: List queryable instance values
        call: render-metrics.listapplicationfiltervalues
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/filters/http
      name: metrics-filters-http
      description: REST surface for metrics-filters-http.
      operations:
      - method: GET
        name: listhttpfiltervalues
        description: List queryable status codes and host values
        call: render-metrics.listhttpfiltervalues
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/filters/path
      name: metrics-filters-path
      description: REST surface for metrics-filters-path.
      operations:
      - method: GET
        name: listpathfiltervalues
        description: List queryable paths
        call: render-metrics.listpathfiltervalues
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/http-latency
      name: metrics-http-latency
      description: REST surface for metrics-http-latency.
      operations:
      - method: GET
        name: gethttplatency
        description: Get HTTP latency
        call: render-metrics.gethttplatency
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/http-requests
      name: metrics-http-requests
      description: REST surface for metrics-http-requests.
      operations:
      - method: GET
        name: gethttprequests
        description: Get HTTP request count
        call: render-metrics.gethttprequests
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/instance-count
      name: metrics-instance-count
      description: REST surface for metrics-instance-count.
      operations:
      - method: GET
        name: getinstancecount
        description: Get instance count
        call: render-metrics.getinstancecount
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/memory
      name: metrics-memory
      description: REST surface for metrics-memory.
      operations:
      - method: GET
        name: getmemory
        description: Get memory usage
        call: render-metrics.getmemory
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/memory-limit
      name: metrics-memory-limit
      description: REST surface for metrics-memory-limit.
      operations:
      - method: GET
        name: getmemorylimit
        description: Get memory limit
        call: render-metrics.getmemorylimit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/memory-target
      name: metrics-memory-target
      description: REST surface for metrics-memory-target.
      operations:
      - method: GET
        name: getmemorytarget
        description: Get memory target
        call: render-metrics.getmemorytarget
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/replication-lag
      name: metrics-replication-lag
      description: REST surface for metrics-replication-lag.
      operations:
      - method: GET
        name: getreplicationlag
        description: Get replica lag
        call: render-metrics.getreplicationlag
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/task-runs-completed
      name: metrics-task-runs-completed
      description: REST surface for metrics-task-runs-completed.
      operations:
      - method: GET
        name: gettaskrunscompleted
        description: Get task runs completed count
        call: render-metrics.gettaskrunscompleted
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/task-runs-queued
      name: metrics-task-runs-queued
      description: REST surface for metrics-task-runs-queued.
      operations:
      - method: GET
        name: gettaskrunsqueued
        description: Get task runs queued count
        call: render-metrics.gettaskrunsqueued
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: render-metrics-mcp
    port: 9090
    transport: http
    description: MCP adapter for Render Public API — Metrics. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: retrieve-metrics-stream
      description: Retrieve metrics stream
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.getownermetricsstream
      outputParameters:
      - type: object
        mapping: $.
    - name: create-update-metrics-stream
      description: Create or update metrics stream
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: render-metrics.upsertownermetricsstream
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-metrics-stream
      description: Delete metrics stream
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: render-metrics.deleteownermetricsstream
      outputParameters:
      - type: object
        mapping: $.
    - name: get-active-connection-count
      description: Get active connection count
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.getactiveconnections
      outputParameters:
      - type: object
        mapping: $.
    - name: get-bandwidth-usage
      description: Get bandwidth usage
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.getbandwidth
      outputParameters:
      - type: object
        mapping: $.
    - name: get-bandwidth-usage-breakdown-traffic
      description: Get bandwidth usage breakdown by traffic source
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.getbandwidthsources
      outputParameters:
      - type: object
        mapping: $.
    - name: get-cpu-usage
      description: Get CPU usage
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.getcpu
      outputParameters:
      - type: object
        mapping: $.
    - name: get-cpu-limit
      description: Get CPU limit
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.getcpulimit
      outputParameters:
      - type: object
        mapping: $.
    - name: get-cpu-target
      description: Get CPU target
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.getcputarget
      outputParameters:
      - type: object
        mapping: $.
    - name: get-disk-capacity
      description: Get disk capacity
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.getdiskcapacity
      outputParameters:
      - type: object
        mapping: $.
    - name: get-disk-usage
      description: Get disk usage
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.getdiskusage
      outputParameters:
      - type: object
        mapping: $.
    - name: list-queryable-instance-values
      description: List queryable instance values
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.listapplicationfiltervalues
      outputParameters:
      - type: object
        mapping: $.
    - name: list-queryable-status-codes-and
      description: List queryable status codes and host values
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.listhttpfiltervalues
      outputParameters:
      - type: object
        mapping: $.
    - name: list-queryable-paths
      description: List queryable paths
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.listpathfiltervalues
      outputParameters:
      - type: object
        mapping: $.
    - name: get-http-latency
      description: Get HTTP latency
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.gethttplatency
      outputParameters:
      - type: object
        mapping: $.
    - name: get-http-request-count
      description: Get HTTP request count
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.gethttprequests
      outputParameters:
      - type: object
        mapping: $.
    - name: get-instance-count
      description: Get instance count
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.getinstancecount
      outputParameters:
      - type: object
        mapping: $.
    - name: get-memory-usage
      description: Get memory usage
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.getmemory
      outputParameters:
      - type: object
        mapping: $.
    - name: get-memory-limit
      description: Get memory limit
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.getmemorylimit
      outputParameters:
      - type: object
        mapping: $.
    - name: get-memory-target
      description: Get memory target
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.getmemorytarget
      outputParameters:
      - type: object
        mapping: $.
    - name: get-replica-lag
      description: Get replica lag
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.getreplicationlag
      outputParameters:
      - type: object
        mapping: $.
    - name: get-task-runs-completed-count
      description: Get task runs completed count
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.gettaskrunscompleted
      outputParameters:
      - type: object
        mapping: $.
    - name: get-task-runs-queued-count
      description: Get task runs queued count
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: render-metrics.gettaskrunsqueued
      outputParameters:
      - type: object
        mapping: $.