GET/agents/automations/available-tools

List available automation tools

Returns the tools available to the authenticated caller for use when creating or updating an automation.

Fine-grained access tokens for "List available automation tools"

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

This endpoint does not require repository permissions.

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

2 status codes

200Available automation tools retrieved successfully

idstringrequired

A presentation-category identifier controlled by CMC.

titlestringrequired

The human-readable group title.

toolsarray<object>required

The tools currently presented in this group.

401Authentication required

messagestringrequired

Summary message (e.g. "Validation Failed", "Not Found")

errorsarray<object>optional

List of validation errors (present only for 422 responses)

documentation_urlstringrequired

URL to relevant API documentation

Error handling

A 401 is returned: Authentication required.

import { Client } from "@octridev/github";

const client = new Client({
  baseUrl: "https://api.github.com",
});

const result = await client.availableTools.list();

[
  {
    "id": "issues",
    "title": "Issues",
    "tools": [
      {
        "id": "github/issue_read",
        "title": "Read issue",
        "description": "Fetch a single issue by its number, including its title, body, state, labels, assignees, and other metadata.",
        "scope": "read"
      }
    ]
  }
]

Response

Errors