---
title: "List available automation triggers for a repository"
method: GET
path: "/agents/repos/{owner}/{repo}/automations/available-triggers"
tags: ["agent-automations"]
---

# List available automation triggers for a repository

`GET /agents/repos/{owner}/{repo}/automations/available-triggers`

## Request

- Base URL: `https://api.github.com`
- URL: `https://api.github.com/agents/repos/{owner}/{repo}/automations/available-triggers`
- Auth: none declared

> [!NOTE]
> This endpoint is in public preview and is subject to change.

Lists available triggers for automations in a repository.

Each available trigger includes a title and description that can be presented
in user interfaces, plus a machine-readable schema of filters supported by the
trigger.

GitHub App installation access tokens can list available automation triggers.
The installation must belong to the repository owner and the token must have
"Agent tasks" repository permissions (read).

To call this endpoint, OAuth app tokens and personal access tokens (classic) need:

* the `repo` scope for private or internal repositories
* the `repo` scope or `public_repo` scope for public repositories

**Fine-grained access tokens for "List available automation triggers for a repository"**

This endpoint works with the following fine-grained token types:

* [GitHub App user access tokens](https://docs.github.com/enterprise-cloud@latest/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app)
* [GitHub App installation access tokens](https://docs.github.com/enterprise-cloud@latest/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app)
* [Fine-grained personal access tokens](https://docs.github.com/enterprise-cloud@latest/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token)

The fine-grained token must have the following permission set:

* "Agent tasks" repository permissions (read)

## Path parameters

- `owner` string, required
- `repo` string, required

## Response `200`

Available automation triggers retrieved successfully

- object[]
  - `id` string, required: The unique identifier of the trigger.
  - `title` string, required: The human-readable name of the trigger.
  - `description` string, required: A short description of when the trigger fires.
  - `fields` object[], required: The fields that can be specified to configure this trigger.
    - `id` string, required: The stable identifier of the field.
    - `label` string, required: The human-readable name of the field.
    - `required` boolean, required: Whether the field must be provided.
    - `description` string: The human-readable description of the field.
    - `schema` union, required: A JSON Schema fragment describing the expected structure of the field value.
      - object
        - `type` 'string', required
        - `enum` string[]: The allowed string values.
        - `minLength` integer: The minimum accepted string length.
      - object
        - `type` 'array', required
        - `items` object, required
          - `type` 'string', required
          - `enum` string[]: The allowed string item values.
          - `minLength` integer: The minimum accepted string item length.
        - `minItems` integer: The minimum accepted number of array items.
        - `maxItems` integer: The maximum accepted number of array items.
        - `uniqueItems` boolean: Whether duplicate array items are rejected.
      - object
        - `type` 'integer', required
        - `enum` integer[]: The allowed integer values.
        - `minimum` integer: The minimum accepted integer value.
        - `maximum` integer: The maximum accepted integer value.

## Other responses

- `401`: Authentication required
- `404`: Repository not found, inaccessible, or automations unavailable

## Changes

- **2026-10-27** `2bbf5140540d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/github/apis/enterprise-cloud/changes/agents/repos/:owner/:repo/automations/available-triggers/get.md)

---

[API](https://skmtc.dev/github/apis/enterprise-cloud.md) - [All operations](https://skmtc.dev/github/apis/enterprise-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/github/apis/enterprise-cloud/revisions/3b55ce443f5c?raw)