Blockdaemon Management API — Usage and Audit

naftiko: 1.0.0-alpha2
info:
  label: Blockdaemon Management API — Usage and Audit
  description: Current-period Compute Unit and request usage metrics plus organization audit logs.
  tags:
  - Blockdaemon
  - Management
  - Metrics
  - Audit
  - FinOps
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    BLOCKDAEMON_API_KEY: BLOCKDAEMON_API_KEY
capability:
  consumes:
  - type: http
    namespace: management-usage
    baseUri: https://svc.blockdaemon.com
    description: Management API metrics endpoints.
    resources:
    - name: cu-usage
      path: /management/v1/metrics/quota-usage
      operations:
      - name: getquotausage
        method: GET
        description: Returns total Compute Units consumed in the current period.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters: []
    - name: request-usage
      path: /management/v1/metrics/request-usage
      operations:
      - name: getrequestusage
        method: GET
        description: Returns request usage metrics for the current period.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters: []
    - name: audit-logs
      path: /management/v1/audit-logs
      operations:
      - name: getauditlogs
        method: GET
        description: Returns the logs associated with the organization.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters: []
    authentication:
      type: apikey
      key: X-API-Key
      value: '{{env.BLOCKDAEMON_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: management-usage-rest
    port: 8080
    description: REST adapter for usage metrics.
    resources:
    - path: /v1/management/quota-usage
      name: cu-usage
      description: REST surface for quota usage.
      operations:
      - method: GET
        name: getquotausage
        description: Get current period CU usage.
        call: management-usage.getquotausage
        with: {}
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: management-usage-mcp
    port: 9090
    transport: http
    description: MCP adapter for usage metrics.
    tools:
    - name: blockdaemon-get-cu-usage
      description: Get total Compute Units consumed this period.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: management-usage.getquotausage
      with: {}
      outputParameters:
      - type: object
        mapping: $.
    - name: blockdaemon-get-request-usage
      description: Get request usage metrics this period.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: management-usage.getrequestusage
      with: {}
      outputParameters:
      - type: object
        mapping: $.
    - name: blockdaemon-get-audit-logs
      description: Get organization audit logs.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: management-usage.getauditlogs
      with: {}
      outputParameters:
      - type: object
        mapping: $.