Datadog API — Across

naftiko: 1.0.0-alpha2
info:
  label: Datadog API — Across
  description: 'Datadog API — Across. 6 operations. Lead operation: Datadog Query Scalar Data Across Multiple Products. Self-contained
    Naftiko capability covering one Datadog business surface.'
  tags:
  - Datadog
  - Across
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    DATADOG_API_KEY: DATADOG_API_KEY
capability:
  consumes:
  - type: http
    namespace: datadog-across
    baseUri: https://{subdomain}.{site}
    description: Datadog API — Across business capability. Self-contained, no shared references.
    resources:
    - name: api-v2-query-scalar
      path: /api/v2/query/scalar
      operations:
      - name: queryscalardata
        method: POST
        description: Datadog Query Scalar Data Across Multiple Products
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v2-query-timeseries
      path: /api/v2/query/timeseries
      operations:
      - name: querytimeseriesdata
        method: POST
        description: Datadog Query Timeseries Data Across Multiple Products
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v2-usage-cost_by_org
      path: /api/v2/usage/cost_by_org
      operations:
      - name: getcostbyorg
        method: GET
        description: Datadog Get Cost Across Multi-org Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: start_month
          in: query
          type: string
          description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month.'
          required: true
        - name: end_month
          in: query
          type: string
          description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month.'
    - name: api-v2-usage-estimated_cost
      path: /api/v2/usage/estimated_cost
      operations:
      - name: getestimatedcostbyorg
        method: GET
        description: Datadog Get Estimated Cost Across Your Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: view
          in: query
          type: string
          description: String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available
            views are `summary` and `sub-org`. Defaults to `summary`.
        - name: start_month
          in: query
          type: string
          description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month. **Either
            start_month or start_date should be specified, but not b'
        - name: end_month
          in: query
          type: string
          description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month.'
        - name: start_date
          in: query
          type: string
          description: 'Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost beginning this day. **Either
            start_month or start_date should be specified, but not bo'
        - name: end_date
          in: query
          type: string
          description: 'Datetime in ISO-8601 format, UTC, precise to day: `[YYYY-MM-DD]` for cost ending this day.'
        - name: include_connected_accounts
          in: query
          type: boolean
          description: Boolean to specify whether to include accounts connected to the current account as partner customers
            in the Datadog partner network program. Defaults to `false`
    - name: api-v2-usage-historical_cost
      path: /api/v2/usage/historical_cost
      operations:
      - name: gethistoricalcostbyorg
        method: GET
        description: Datadog Get Historical Cost Across Your Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: view
          in: query
          type: string
          description: String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available
            views are `summary` and `sub-org`.  Defaults to `summary`
        - name: start_month
          in: query
          type: string
          description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost beginning this month.'
          required: true
        - name: end_month
          in: query
          type: string
          description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for cost ending this month.'
        - name: include_connected_accounts
          in: query
          type: boolean
          description: Boolean to specify whether to include accounts connected to the current account as partner customers
            in the Datadog partner network program. Defaults to `false`
    - name: api-v2-usage-projected_cost
      path: /api/v2/usage/projected_cost
      operations:
      - name: getprojectedcost
        method: GET
        description: Datadog Get Projected Cost Across Your Account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: view
          in: query
          type: string
          description: String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available
            views are `summary` and `sub-org`. Defaults to `summary`.
        - name: include_connected_accounts
          in: query
          type: boolean
          description: Boolean to specify whether to include accounts connected to the current account as partner customers
            in the Datadog partner network program. Defaults to `false`
    authentication:
      type: bearer
      token: '{{env.DATADOG_API_KEY}}'
  exposes:
  - type: rest
    namespace: datadog-across-rest
    port: 8080
    description: REST adapter for Datadog API — Across. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/api/v2/query/scalar
      name: api-v2-query-scalar
      description: REST surface for api-v2-query-scalar.
      operations:
      - method: POST
        name: queryscalardata
        description: Datadog Query Scalar Data Across Multiple Products
        call: datadog-across.queryscalardata
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/query/timeseries
      name: api-v2-query-timeseries
      description: REST surface for api-v2-query-timeseries.
      operations:
      - method: POST
        name: querytimeseriesdata
        description: Datadog Query Timeseries Data Across Multiple Products
        call: datadog-across.querytimeseriesdata
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/usage/cost-by-org
      name: api-v2-usage-cost-by-org
      description: REST surface for api-v2-usage-cost_by_org.
      operations:
      - method: GET
        name: getcostbyorg
        description: Datadog Get Cost Across Multi-org Account
        call: datadog-across.getcostbyorg
        with:
          start_month: rest.start_month
          end_month: rest.end_month
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/usage/estimated-cost
      name: api-v2-usage-estimated-cost
      description: REST surface for api-v2-usage-estimated_cost.
      operations:
      - method: GET
        name: getestimatedcostbyorg
        description: Datadog Get Estimated Cost Across Your Account
        call: datadog-across.getestimatedcostbyorg
        with:
          view: rest.view
          start_month: rest.start_month
          end_month: rest.end_month
          start_date: rest.start_date
          end_date: rest.end_date
          include_connected_accounts: rest.include_connected_accounts
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/usage/historical-cost
      name: api-v2-usage-historical-cost
      description: REST surface for api-v2-usage-historical_cost.
      operations:
      - method: GET
        name: gethistoricalcostbyorg
        description: Datadog Get Historical Cost Across Your Account
        call: datadog-across.gethistoricalcostbyorg
        with:
          view: rest.view
          start_month: rest.start_month
          end_month: rest.end_month
          include_connected_accounts: rest.include_connected_accounts
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v2/usage/projected-cost
      name: api-v2-usage-projected-cost
      description: REST surface for api-v2-usage-projected_cost.
      operations:
      - method: GET
        name: getprojectedcost
        description: Datadog Get Projected Cost Across Your Account
        call: datadog-across.getprojectedcost
        with:
          view: rest.view
          include_connected_accounts: rest.include_connected_accounts
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: datadog-across-mcp
    port: 9090
    transport: http
    description: MCP adapter for Datadog API — Across. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: datadog-query-scalar-data-across
      description: Datadog Query Scalar Data Across Multiple Products
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: datadog-across.queryscalardata
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: datadog-query-timeseries-data-across
      description: Datadog Query Timeseries Data Across Multiple Products
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: datadog-across.querytimeseriesdata
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: datadog-get-cost-across-multi
      description: Datadog Get Cost Across Multi-org Account
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: datadog-across.getcostbyorg
      with:
        start_month: tools.start_month
        end_month: tools.end_month
      outputParameters:
      - type: object
        mapping: $.
    - name: datadog-get-estimated-cost-across
      description: Datadog Get Estimated Cost Across Your Account
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: datadog-across.getestimatedcostbyorg
      with:
        view: tools.view
        start_month: tools.start_month
        end_month: tools.end_month
        start_date: tools.start_date
        end_date: tools.end_date
        include_connected_accounts: tools.include_connected_accounts
      outputParameters:
      - type: object
        mapping: $.
    - name: datadog-get-historical-cost-across
      description: Datadog Get Historical Cost Across Your Account
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: datadog-across.gethistoricalcostbyorg
      with:
        view: tools.view
        start_month: tools.start_month
        end_month: tools.end_month
        include_connected_accounts: tools.include_connected_accounts
      outputParameters:
      - type: object
        mapping: $.
    - name: datadog-get-projected-cost-across
      description: Datadog Get Projected Cost Across Your Account
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: datadog-across.getprojectedcost
      with:
        view: tools.view
        include_connected_accounts: tools.include_connected_accounts
      outputParameters:
      - type: object
        mapping: $.