agent-automations

Get an automation for a repository

Changed on

Returns an automation by ID in a repository.

User-owned automations are visible only to their creator. Repository-owned automations are visible to anyone with read access to the repository. The created_by field identifies the creator and is distinct from the automation's owner_type.

Fine-grained access tokens for "Get an automation 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/{automation_id}

Request

  • Base URL: https://api.github.com
  • URL: https://api.github.com/agents/repos/{owner}/{repo}/automations/{automation_id}
  • 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.

automation_idstring required

The unique identifier of the automation.

Response

Automation retrieved successfully

idstring required

The unique identifier of the automation.

namestring required

The name of the automation.

enabledboolean

Whether the automation is currently enabled.

owner_type'user' | 'repository'

Who owns the automation. user keeps it private to its creator and its runs act as that user. repository makes it belong to the repository, visible to anyone with read access to the repository, and its runs act as the Copilot app rather than as a person.

write_scope'trigger' | 'repository'

Controls which repository resources a run may modify. trigger limits writes to the resource that started the run, when one exists, and resources created during the run; repository allows writes to any resource in the repository. Supported values: trigger, repository.

require_actor_write_permissionboolean

When true, event-triggered runs require the event actor to have repo write permission, even when the org's allow_read_access_triggers policy is enabled. Does not apply to interval-scheduled runs, which always run as the automation owner.

promptstring required

The prompt template for the automation.

toolsstring[]

The tools available to the automation.

allowed_custom_agentsstring[]

Custom agents (subagents) this automation is allowed to invoke.

modelstring

The model to use for sessions triggered by this automation. Omit to use the platform default.

reasoning_effortstring

The reasoning effort to use for sessions triggered by this automation. Omit or leave empty for no override. Currently supported values: none, low, medium, high, xhigh, max

created_atstring date-time required

When the automation was created.

updated_atstring date-time required

When the automation was last updated.

Changes