automation-anywhere AuditData API

openapi: 3.2.0
info:
  title: Automation Anywhere Bot Insight Audit Data API
  description: The Automation Anywhere Bot Insight API exposes real-time business process analytics and operational intelligence data collected during bot execution.
  version: '2019'
  contact:
    name: Automation Anywhere Support
    url: https://support.automationanywhere.com
  termsOfService: https://www.automationanywhere.com/terms-of-service
servers:
- url: https://{controlRoomUrl}/v2/botinsight/data/api
  description: Automation Anywhere Bot Insight API
  variables:
    controlRoomUrl:
      default: your-control-room.automationanywhere.com
      description: Your Control Room hostname
security:
- bearerAuth: []
- xAuthorization: []
tags:
- name: AuditData
  description: Retrieve Control Room audit trail data
paths:
  /getaudittraildata/{startIndex}/{startDate}:
    get:
      operationId: getAuditTrailData
      summary: Get audit trail data
      description: Retrieves Control Room audit trail records capturing administrative and operational events such as user logins, bot deployments, role changes, and configuration updates. Results are paginated at 1000 records per request. Requires Bot Insight Admin or AAE_Admin role.
      tags:
      - AuditData
      parameters:
      - $ref: '#/components/parameters/StartIndexParam'
      - $ref: '#/components/parameters/StartDateParam'
      responses:
        '200':
          description: Audit trail records
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuditTrailResponse'
        '400':
          description: Bad request or invalid date format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Authentication required or insufficient permissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    AuditTrailResponse:
      type: object
      description: Paginated audit trail records from the Control Room
      properties:
        totalRecords:
          type: integer
          description: Total number of audit records available from the start date
        auditData:
          type: array
          description: List of audit trail records
          items:
            $ref: '#/components/schemas/AuditRecord'
    Error:
      type: object
      description: Standard error response
      properties:
        code:
          type: string
          description: Error code
        message:
          type: string
          description: Human-readable error description
    AuditRecord:
      type: object
      description: A single Control Room audit trail event record
      properties:
        id:
          type: integer
          format: int64
          description: Unique identifier of the audit record
        activityType:
          type: string
          description: Category of the audit activity (e.g., USER_LOGIN, BOT_DEPLOY)
        createdBy:
          type: string
          description: Username of the user who triggered the audited event
        createdOn:
          type: string
          format: date-time
          description: ISO 8601 timestamp of the audited event
        detail:
          type: string
          description: Detailed description of the audited action
        environmentName:
          type: string
          description: Name of the Control Room environment
        eventDescription:
          type: string
          description: Human-readable description of the event
        hostName:
          type: string
          description: Hostname of the system where the event occurred
        objectName:
          type: string
          description: Name of the resource object affected by the event
        requestId:
          type: string
          description: Unique request identifier for tracing
        source:
          type: string
          description: Source system or interface that triggered the event
        status:
          type: string
          description: Outcome status of the audited action
        userName:
          type: string
          description: Username associated with the event
  parameters:
    StartIndexParam:
      name: startIndex
      in: path
      required: true
      description: Zero-based record index for pagination. Set to 0 to retrieve the first page of 1000 records, then increment by 1000 for subsequent pages.
      schema:
        type: integer
        minimum: 0
        default: 0
    StartDateParam:
      name: startDate
      in: path
      required: true
      description: Start date for the data query in ISO 8601 format (YYYY-MM-DD)
      schema:
        type: string
        format: date
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token obtained from the Authentication API
    xAuthorization:
      type: apiKey
      in: header
      name: X-Authorization
      description: JWT token obtained from the Authentication API
externalDocs:
  description: Automation Anywhere Bot Insight API Documentation
  url: https://docs.automationanywhere.com/bundle/enterprise-v11.3/page/enterprise/topics/bot-insight/user/bot-insight-apis.html