openapi: 3.1.0
info:
  title: AppDynamics Alert and Respond Actions Metrics API
  description: The AppDynamics Alert and Respond API enables programmatic management of health rules, policies, and actions within the AppDynamics Controller. Developers can create, update, and delete health rules that define performance thresholds, configure alerting policies that determine how violations are handled, and set up automated response actions. This API is essential for automating incident response workflows and integrating AppDynamics alerting with external notification and ticketing systems.
  version: 23.x
  contact:
    name: Splunk AppDynamics Support
    url: https://www.appdynamics.com/support
  termsOfService: https://www.cisco.com/c/en/us/about/legal/cloud-and-software.html
servers:
- url: https://{controller-host}/controller
  description: AppDynamics Controller
  variables:
    controller-host:
      default: example.saas.appdynamics.com
      description: The hostname of your AppDynamics Controller instance.
security:
- bearerAuth: []
- basicAuth: []
tags:
- name: Metrics
  description: Retrieve metric hierarchy and metric data for monitored applications with configurable time ranges and aggregation.
paths:
  /rest/applications/{applicationId}/metrics:
    get:
      operationId: listMetricHierarchy
      summary: List metric hierarchy for an application
      description: Returns the metric tree hierarchy for the specified application. Use this to discover available metric paths before retrieving metric data. Supports wildcard characters in the metric-path parameter.
      tags:
      - Metrics
      parameters:
      - $ref: '#/components/parameters/applicationId'
      - name: metric-path
        in: query
        required: false
        description: The metric path to browse. Supports wildcard characters. If not specified, returns the top level of the metric hierarchy.
        schema:
          type: string
      - $ref: '#/components/parameters/outputFormat'
      responses:
        '200':
          description: Successful retrieval of metric hierarchy
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MetricFolder'
        '401':
          description: Unauthorized - invalid or missing credentials
        '404':
          description: Application not found
  /rest/applications/{applicationId}/metric-data:
    get:
      operationId: getMetricData
      summary: Get metric data for an application
      description: Returns metric data for the specified metric path and time range. The rollup parameter controls whether data is aggregated into a single value or returned as individual data points. Supports wildcard characters in the metric-path parameter.
      tags:
      - Metrics
      parameters:
      - $ref: '#/components/parameters/applicationId'
      - name: metric-path
        in: query
        required: true
        description: The full metric path to retrieve data for. Supports wildcard characters using the pipe delimiter for path levels.
        schema:
          type: string
        example: Application Infrastructure Performance|*|Agent|App|Availability
      - name: time-range-type
        in: query
        required: true
        description: The type of time range to use for the query.
        schema:
          type: string
          enum:
          - BEFORE_NOW
          - BEFORE_TIME
          - AFTER_TIME
          - BETWEEN_TIMES
      - name: duration-in-mins
        in: query
        required: false
        description: Duration in minutes for BEFORE_NOW and BEFORE_TIME time range types.
        schema:
          type: integer
          minimum: 1
      - name: start-time
        in: query
        required: false
        description: Start time in Unix epoch milliseconds for AFTER_TIME and BETWEEN_TIMES time range types.
        schema:
          type: integer
          format: int64
      - name: end-time
        in: query
        required: false
        description: End time in Unix epoch milliseconds for BEFORE_TIME and BETWEEN_TIMES time range types.
        schema:
          type: integer
          format: int64
      - name: rollup
        in: query
        required: false
        description: When true, aggregates data into a single data point. When false, returns individual data points. Defaults to true.
        schema:
          type: boolean
          default: true
      - $ref: '#/components/parameters/outputFormat'
      responses:
        '200':
          description: Successful retrieval of metric data
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MetricData'
        '400':
          description: Bad request - invalid parameters or metric path
        '401':
          description: Unauthorized - invalid or missing credentials
        '404':
          description: Application or metric not found
components:
  schemas:
    MetricData:
      type: object
      description: Metric data returned for a specific metric path containing one or more data points depending on the rollup parameter.
      properties:
        metricId:
          type: integer
          format: int64
          description: The internal numeric identifier for the metric.
        metricName:
          type: string
          description: The full metric path name.
        metricPath:
          type: string
          description: The hierarchical path of the metric using pipe delimiters.
        frequency:
          type: string
          description: The frequency of the metric data points.
        metricValues:
          type: array
          description: The array of metric data point values.
          items:
            $ref: '#/components/schemas/MetricValue'
    MetricValue:
      type: object
      description: A single metric data point with statistical values for a time period.
      properties:
        startTimeInMillis:
          type: integer
          format: int64
          description: The start time of this data point in Unix epoch milliseconds.
        occurrences:
          type: integer
          description: The number of observations in this time period.
        current:
          type: integer
          format: int64
          description: The current or last observed value.
        min:
          type: integer
          format: int64
          description: The minimum value observed in this time period.
        max:
          type: integer
          format: int64
          description: The maximum value observed in this time period.
        count:
          type: integer
          format: int64
          description: The total count of observations.
        sum:
          type: integer
          format: int64
          description: The sum of all values in this time period.
        value:
          type: integer
          format: int64
          description: The computed value based on the rollup type.
        standardDeviation:
          type: number
          format: double
          description: The standard deviation of values in this time period.
    MetricFolder:
      type: object
      description: A node in the metric hierarchy representing either a folder or a leaf metric.
      properties:
        name:
          type: string
          description: The name of this metric folder or metric.
        type:
          type: string
          description: The type of this node - either folder or leaf.
          enum:
          - folder
          - leaf
  parameters:
    applicationId:
      name: applicationId
      in: path
      required: true
      description: The numeric ID or name of the business application.
      schema:
        type: string
    outputFormat:
      name: output
      in: query
      required: false
      description: The output format for the response. Defaults to XML if not specified.
      schema:
        type: string
        enum:
        - JSON
        - XML
        default: XML
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: OAuth 2.0 access token obtained from the /controller/api/oauth/access_token endpoint.
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic authentication using user@account:password format.
externalDocs:
  description: Alert and Respond API Documentation
  url: https://docs.appdynamics.com/appd/23.x/latest/en/extend-appdynamics/appdynamics-apis/alert-and-respond-api