agent-automations

List automations for a repository

Changed on

Returns a paginated list of the authenticated user's automations for a repository, together with every repository-owned automation in it. total_count is the number of caller-visible automations matching the supplied filters across all pages. Repository-owned automations are visible to anyone with read access to the repository, so the results are not limited to automations the caller created. Use the owner_type field on each automation to tell the two apart.

Fine-grained access tokens for "List automations for a repository"

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

The fine-grained token must have one of the following permission sets for each repository accessed by this request:

  • "Agent tasks" repository permissions (read)
  • "Contents" repository permissions (read)

The required permission set depends on each repository's Automation permission configuration.

GitHub App installation access tokens are not supported for this endpoint.

get/agents/repos/{owner}/{repo}/automations

Request

  • Base URL: https://api.github.com
  • URL: https://api.github.com/agents/repos/{owner}/{repo}/automations
  • Auth: none declared

Path parameters

ownerstring required

The account owner of the repository. The name is not case sensitive.

repostring required

The name of the repository. The name is not case sensitive.

Query parameters

pageinteger

The page number of the results to fetch.

per_pageinteger

The number of results per page (max 100).

owner_type'user' | 'repository'

Filter automations by owner type. user returns automations owned by their creator, repository returns automations owned by the repository. Omit to return both.

Response

Automations retrieved successfully

total_countinteger required

Total count of caller-visible automations matching the supplied filters (across all pages)

Changes