> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qa.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# List automations

> List the project's automations: "when X, do Y" rules that start a chat-assistant task or a test plan run on a schedule or from an API call. Includes each automation's trigger, action, enabled state, and last/next fire time.



## OpenAPI

````yaml /api-reference/api.json get /v1/automations
openapi: 3.0.0
info:
  title: QA.tech API
  version: 1.0.0
  contact:
    name: QA.tech
    url: https://qa.tech
    email: support@qa.tech
  description: API for triggering and managing AI-powered test runs
servers:
  - url: https://api.qa.tech
    description: Production
    variables: {}
security:
  - BearerAuth: []
tags:
  - name: Runs
  - name: Infrastructure
  - name: Test Cases
  - name: Application Builds
  - name: Status badge
  - name: Remote Tunnels
  - name: Chat
  - name: Applications
  - name: Features
  - name: Metrics
  - name: Release Checks
  - name: Projects
  - name: Knowledge
  - name: Rules
  - name: Issues
  - name: Automations
paths:
  /v1/automations:
    get:
      tags:
        - Automations
      summary: List automations
      description: >-
        List the project's automations: "when X, do Y" rules that start a
        chat-assistant task or a test plan run on a schedule or from an API
        call. Includes each automation's trigger, action, enabled state, and
        last/next fire time.
      operationId: ListAutomations
      parameters:
        - name: query
          in: query
          required: true
          schema:
            $ref: '#/components/schemas/ProjectScopedRequest'
          explode: false
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAutomationsResponse'
components:
  schemas:
    ProjectScopedRequest:
      type: object
      properties:
        projectShortId:
          allOf:
            - $ref: '#/components/schemas/ProjectShortId'
          description: >-
            Target a specific project by its prefixed short ID
            (proj-slug_shortId or proj_shortId), as returned by the projects
            API. Required for organization-scoped API keys; project-scoped keys
            may only pass their own project's short ID.
      description: >-
        Mixin for project-scoped requests: an optional per-call project
        override.
    ListAutomationsResponse:
      type: object
      required:
        - automations
      properties:
        automations:
          type: array
          items:
            $ref: '#/components/schemas/Automation'
    ProjectShortId:
      type: string
      pattern: ^proj(-.+_.+|_.+)$
    Automation:
      type: object
      required:
        - id
        - name
        - description
        - isEnabled
        - trigger
        - action
        - lastTriggeredAt
        - nextRunAt
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
          nullable: true
        isEnabled:
          type: boolean
          description: >-
            Disabled automations never fire on their schedule and reject API
            triggers.
        trigger:
          $ref: '#/components/schemas/AutomationTrigger'
        action:
          $ref: '#/components/schemas/AutomationAction'
        lastTriggeredAt:
          type: string
          nullable: true
        nextRunAt:
          type: string
          nullable: true
          description: >-
            Next scheduled fire time for enabled schedule automations; null
            otherwise.
        createdAt:
          type: string
        updatedAt:
          type: string
    AutomationTrigger:
      anyOf:
        - $ref: '#/components/schemas/AutomationScheduleTrigger'
        - $ref: '#/components/schemas/AutomationApiWebhookTrigger'
        - $ref: '#/components/schemas/AutomationReservedTrigger'
    AutomationAction:
      anyOf:
        - $ref: '#/components/schemas/AutomationChatAction'
        - $ref: '#/components/schemas/AutomationRunTestPlanAction'
      description: What the automation does when it fires.
    AutomationScheduleTrigger:
      type: object
      required:
        - type
        - cron
      properties:
        type:
          type: string
          enum:
            - schedule
        cron:
          type: string
          minLength: 1
          description: >-
            Standard 5-field cron expression (minute hour day-of-month month
            day-of-week), evaluated in `timezone`. Example: `0 9 * * 1` for
            Mondays at 09:00.
        timezone:
          type: string
          description: >-
            IANA timezone the cron is evaluated in, such as `Europe/Stockholm`.
            Defaults to `UTC`.
        once:
          type: boolean
          description: >-
            Fire once and then disable the automation. Pin minute, hour, day and
            month in `cron` when set. Defaults to `false`.
      description: Fire on a cron schedule.
    AutomationApiWebhookTrigger:
      type: object
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - api_webhook
      description: >-
        Only fire when called through `POST /automations/{automationId}/trigger`
        (CI, deploy hooks, monitoring).
    AutomationReservedTrigger:
      type: object
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - graph_change
            - github_event
      description: Reserved trigger types that are stored but not yet emitted.
    AutomationChatAction:
      type: object
      required:
        - type
        - prompt
      properties:
        type:
          type: string
          enum:
            - chat
        prompt:
          type: string
          minLength: 1
          description: >-
            Instructions for the assistant. It runs without a user present, so
            describe the full task and the expected outcome.
      description: >-
        Start a chat conversation with the QA.tech assistant that works through
        `prompt` autonomously.
    AutomationRunTestPlanAction:
      type: object
      required:
        - type
        - testPlanShortId
      properties:
        type:
          type: string
          enum:
            - run_test_plan
        testPlanShortId:
          $ref: '#/components/schemas/TestPlanShortId'
      description: Run every test case in a test plan.
    TestPlanShortId:
      type: string
      pattern: ^pln(-.+_.+|_.+)$
  securitySchemes:
    BearerAuth:
      type: http
      scheme: Bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.