GitHub

GitHub Actions API

Endpoints to manage GitHub Actions using the REST API.

GitHub OpenAPI

Operations 137

GET /enterprises/{enterprise}/actions/cache/usage GitHub Get GitHub Actions Cache Usage for an Enterprise #
GET /enterprises/{enterprise}/actions/cache/usage-policy GitHub Get GitHub Actions Cache Usage Policy for an Enterprise #
PATCH /enterprises/{enterprise}/actions/cache/usage-policy GitHub Set GitHub Actions Cache Usage Policy for an Enterprise #
GET /enterprises/{enterprise}/actions/permissions/workflow GitHub Get Default Workflow Permissions for an Enterprise #
PUT /enterprises/{enterprise}/actions/permissions/workflow GitHub Set Default Workflow Permissions for an Enterprise #
GET /orgs/{org}/actions/cache/usage GitHub Get GitHub Actions Cache Usage for an Organization #
GET /orgs/{org}/actions/cache/usage-by-repository GitHub List Repositories with GitHub Actions Cache Usage for an Organization #
GET /orgs/{org}/actions/permissions GitHub Get GitHub Actions Permissions for an Organization #
PUT /orgs/{org}/actions/permissions GitHub Set GitHub Actions Permissions for an Organization #
GET /orgs/{org}/actions/permissions/repositories GitHub List Selected Repositories Enabled for GitHub Actions in an Organization #
PUT /orgs/{org}/actions/permissions/repositories GitHub Set Selected Repositories Enabled for GitHub Actions in an Organization #
PUT /orgs/{org}/actions/permissions/repositories/{repository_id} GitHub Enable a Selected Repository for GitHub Actions in an Organization #
DELETE /orgs/{org}/actions/permissions/repositories/{repository_id} GitHub Disable a Selected Repository for GitHub Actions in an Organization #
GET /orgs/{org}/actions/permissions/selected-actions GitHub Get Allowed Actions for an Organization #
PUT /orgs/{org}/actions/permissions/selected-actions GitHub Set Allowed Actions for an Organization #
GET /orgs/{org}/actions/permissions/workflow GitHub Get Default Workflow Permissions for an Organization #
PUT /orgs/{org}/actions/permissions/workflow GitHub Set Default Workflow Permissions for an Organization #
GET /orgs/{org}/actions/runner-groups GitHub List Self-hosted Runner Groups for an Organization #
POST /orgs/{org}/actions/runner-groups GitHub Create a Self-hosted Runner Group for an Organization #
GET /orgs/{org}/actions/runner-groups/{runner_group_id} GitHub Get a Self-hosted Runner Group for an Organization #
PATCH /orgs/{org}/actions/runner-groups/{runner_group_id} GitHub Update a Self-hosted Runner Group for an Organization #
DELETE /orgs/{org}/actions/runner-groups/{runner_group_id} GitHub Delete a Self-hosted Runner Group from an Organization #
GET /orgs/{org}/actions/runner-groups/{runner_group_id}/repositories GitHub List Repository Access to a Self-hosted Runner Group in an Organization #
PUT /orgs/{org}/actions/runner-groups/{runner_group_id}/repositories GitHub Set Repository Access for a Self-hosted Runner Group in an Organization #
PUT /orgs/{org}/actions/runner-groups/{runner_group_id}/repositories/{repository_id} GitHub Add Repository Access to a Self-hosted Runner Group in an Organization #
DELETE /orgs/{org}/actions/runner-groups/{runner_group_id}/repositories/{repository_id} GitHub Remove Repository Access to a Self-hosted Runner Group in an Organization #
GET /orgs/{org}/actions/runner-groups/{runner_group_id}/runners GitHub List Self-hosted Runners in a Group for an Organization #
PUT /orgs/{org}/actions/runner-groups/{runner_group_id}/runners GitHub Set Self-hosted Runners in a Group for an Organization #
PUT /orgs/{org}/actions/runner-groups/{runner_group_id}/runners/{runner_id} GitHub Add a Self-hosted Runner to a Group for an Organization #
DELETE /orgs/{org}/actions/runner-groups/{runner_group_id}/runners/{runner_id} GitHub Remove a Self-hosted Runner from a Group for an Organization #
GET /orgs/{org}/actions/runners GitHub List Self-hosted Runners for an Organization #
GET /orgs/{org}/actions/runners/downloads GitHub List Runner Applications for an Organization #
POST /orgs/{org}/actions/runners/registration-token GitHub Create a Registration Token for an Organization #
POST /orgs/{org}/actions/runners/remove-token GitHub Create a Remove Token for an Organization #
GET /orgs/{org}/actions/runners/{runner_id} GitHub Get a Self-hosted Runner for an Organization #
DELETE /orgs/{org}/actions/runners/{runner_id} GitHub Delete a Self-hosted Runner from an Organization #
GET /orgs/{org}/actions/runners/{runner_id}/labels GitHub List Labels for a Self-hosted Runner for an Organization #
POST /orgs/{org}/actions/runners/{runner_id}/labels GitHub Add Custom Labels to a Self-hosted Runner for an Organization #
PUT /orgs/{org}/actions/runners/{runner_id}/labels GitHub Set Custom Labels for a Self-hosted Runner for an Organization #
DELETE /orgs/{org}/actions/runners/{runner_id}/labels GitHub Remove All Custom Labels from a Self-hosted Runner for an Organization #
DELETE /orgs/{org}/actions/runners/{runner_id}/labels/{name} GitHub Remove a Custom Label from a Self-hosted Runner for an Organization #
GET /orgs/{org}/actions/secrets GitHub List Organization Secrets #
GET /orgs/{org}/actions/secrets/public-key GitHub Get an Organization Public Key #
GET /orgs/{org}/actions/secrets/{secret_name} GitHub Get an Organization Secret #
PUT /orgs/{org}/actions/secrets/{secret_name} GitHub Create or Update an Organization Secret #
DELETE /orgs/{org}/actions/secrets/{secret_name} GitHub Delete an Organization Secret #
GET /orgs/{org}/actions/secrets/{secret_name}/repositories GitHub List Selected Repositories for an Organization Secret #
PUT /orgs/{org}/actions/secrets/{secret_name}/repositories GitHub Set Selected Repositories for an Organization Secret #
PUT /orgs/{org}/actions/secrets/{secret_name}/repositories/{repository_id} GitHub Add Selected Repository to an Organization Secret #
DELETE /orgs/{org}/actions/secrets/{secret_name}/repositories/{repository_id} GitHub Remove Selected Repository from an Organization Secret #
GET /orgs/{org}/actions/variables GitHub List Organization Variables #
POST /orgs/{org}/actions/variables GitHub Create an Organization Variable #
GET /orgs/{org}/actions/variables/{name} GitHub Get an Organization Variable #
PATCH /orgs/{org}/actions/variables/{name} GitHub Update an Organization Variable #
DELETE /orgs/{org}/actions/variables/{name} GitHub Delete an Organization Variable #
GET /orgs/{org}/actions/variables/{name}/repositories GitHub List Selected Repositories for an Organization Variable #
PUT /orgs/{org}/actions/variables/{name}/repositories GitHub Set Selected Repositories for an Organization Variable #
PUT /orgs/{org}/actions/variables/{name}/repositories/{repository_id} GitHub Add Selected Repository to an Organization Variable #
DELETE /orgs/{org}/actions/variables/{name}/repositories/{repository_id} GitHub Remove Selected Repository from an Organization Variable #
GET /repos/{owner}/{repo}/actions/artifacts GitHub List Artifacts for a Repository #
GET /repos/{owner}/{repo}/actions/artifacts/{artifact_id} GitHub Get an Artifact #
DELETE /repos/{owner}/{repo}/actions/artifacts/{artifact_id} GitHub Delete an Artifact #
GET /repos/{owner}/{repo}/actions/artifacts/{artifact_id}/{archive_format} GitHub Download an Artifact #
GET /repos/{owner}/{repo}/actions/cache/usage GitHub Get GitHub Actions Cache Usage for a Repository #
GET /repos/{owner}/{repo}/actions/cache/usage-policy GitHub Get GitHub Actions Cache Usage Policy for a Repository #
PATCH /repos/{owner}/{repo}/actions/cache/usage-policy GitHub Set GitHub Actions Cache Usage Policy for a Repository #
GET /repos/{owner}/{repo}/actions/caches GitHub List GitHub Actions Caches for a Repository #
DELETE /repos/{owner}/{repo}/actions/caches GitHub Delete GitHub Actions Caches for a Repository (using a Cache Key) #
DELETE /repos/{owner}/{repo}/actions/caches/{cache_id} GitHub Delete a GitHub Actions Cache for a Repository (using a Cache ID) #
GET /repos/{owner}/{repo}/actions/jobs/{job_id} GitHub Get a Job for a Workflow Run #
GET /repos/{owner}/{repo}/actions/jobs/{job_id}/logs GitHub Download Job Logs for a Workflow Run #
POST /repos/{owner}/{repo}/actions/jobs/{job_id}/rerun GitHub Re-run a Job from a Workflow Run #
GET /repos/{owner}/{repo}/actions/oidc/customization/sub GitHub Get the Customization Template for an OIDC Subject Claim for a Repository #
PUT /repos/{owner}/{repo}/actions/oidc/customization/sub GitHub Set the Customization Template for an OIDC Subject Claim for a Repository #
GET /repos/{owner}/{repo}/actions/organization-secrets GitHub List Repository Organization Secrets #
GET /repos/{owner}/{repo}/actions/organization-variables GitHub List Repository Organization Variables #
GET /repos/{owner}/{repo}/actions/permissions GitHub Get GitHub Actions Permissions for a Repository #
PUT /repos/{owner}/{repo}/actions/permissions GitHub Set GitHub Actions Permissions for a Repository #
GET /repos/{owner}/{repo}/actions/permissions/access GitHub Get the Level of Access for Workflows Outside of the Repository #
PUT /repos/{owner}/{repo}/actions/permissions/access GitHub Set the Level of Access for Workflows Outside of the Repository #
GET /repos/{owner}/{repo}/actions/permissions/selected-actions GitHub Get Allowed Actions for a Repository #
PUT /repos/{owner}/{repo}/actions/permissions/selected-actions GitHub Set Allowed Actions for a Repository #
GET /repos/{owner}/{repo}/actions/permissions/workflow GitHub Get Default Workflow Permissions for a Repository #
PUT /repos/{owner}/{repo}/actions/permissions/workflow GitHub Set Default Workflow Permissions for a Repository #
GET /repos/{owner}/{repo}/actions/runners GitHub List Self-hosted Runners for a Repository #
GET /repos/{owner}/{repo}/actions/runners/downloads GitHub List Runner Applications for a Repository #
POST /repos/{owner}/{repo}/actions/runners/registration-token GitHub Create a Registration Token for a Repository #
POST /repos/{owner}/{repo}/actions/runners/remove-token GitHub Create a Remove Token for a Repository #
GET /repos/{owner}/{repo}/actions/runners/{runner_id} GitHub Get a Self-hosted Runner for a Repository #
DELETE /repos/{owner}/{repo}/actions/runners/{runner_id} GitHub Delete a Self-hosted Runner from a Repository #
GET /repos/{owner}/{repo}/actions/runners/{runner_id}/labels GitHub List Labels for a Self-hosted Runner for a Repository #
POST /repos/{owner}/{repo}/actions/runners/{runner_id}/labels GitHub Add Custom Labels to a Self-hosted Runner for a Repository #
PUT /repos/{owner}/{repo}/actions/runners/{runner_id}/labels GitHub Set Custom Labels for a Self-hosted Runner for a Repository #
DELETE /repos/{owner}/{repo}/actions/runners/{runner_id}/labels GitHub Remove All Custom Labels from a Self-hosted Runner for a Repository #
DELETE /repos/{owner}/{repo}/actions/runners/{runner_id}/labels/{name} GitHub Remove a Custom Label from a Self-hosted Runner for a Repository #
GET /repos/{owner}/{repo}/actions/runs GitHub List Workflow Runs for a Repository #
GET /repos/{owner}/{repo}/actions/runs/{run_id} GitHub Get a Workflow Run #
DELETE /repos/{owner}/{repo}/actions/runs/{run_id} GitHub Delete a Workflow Run #
GET /repos/{owner}/{repo}/actions/runs/{run_id}/approvals GitHub Get the Review History for a Workflow Run #
GET /repos/{owner}/{repo}/actions/runs/{run_id}/artifacts GitHub List Workflow Run Artifacts #
GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number} GitHub Get a Workflow Run Attempt #
GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/jobs GitHub List Jobs for a Workflow Run Attempt #
GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/logs GitHub Download Workflow Run Attempt Logs #
POST /repos/{owner}/{repo}/actions/runs/{run_id}/cancel GitHub Cancel a Workflow Run #
GET /repos/{owner}/{repo}/actions/runs/{run_id}/jobs GitHub List Jobs for a Workflow Run #
GET /repos/{owner}/{repo}/actions/runs/{run_id}/logs GitHub Download Workflow Run Logs #
DELETE /repos/{owner}/{repo}/actions/runs/{run_id}/logs GitHub Delete Workflow Run Logs #
GET /repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments GitHub Get Pending Deployments for a Workflow Run #
POST /repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments GitHub Review Pending Deployments for a Workflow Run #
POST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun GitHub Re-run a Workflow #
POST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun-failed-jobs GitHub Re-run Failed Jobs from a Workflow Run #
GET /repos/{owner}/{repo}/actions/secrets GitHub List Repository Secrets #
GET /repos/{owner}/{repo}/actions/secrets/public-key GitHub Get a Repository Public Key #
GET /repos/{owner}/{repo}/actions/secrets/{secret_name} GitHub Get a Repository Secret #
PUT /repos/{owner}/{repo}/actions/secrets/{secret_name} GitHub Create or Update a Repository Secret #
DELETE /repos/{owner}/{repo}/actions/secrets/{secret_name} GitHub Delete a Repository Secret #
GET /repos/{owner}/{repo}/actions/variables GitHub List Repository Variables #
POST /repos/{owner}/{repo}/actions/variables GitHub Create a Repository Variable #
GET /repos/{owner}/{repo}/actions/variables/{name} GitHub Get a Repository Variable #
PATCH /repos/{owner}/{repo}/actions/variables/{name} GitHub Update a Repository Variable #
DELETE /repos/{owner}/{repo}/actions/variables/{name} GitHub Delete a Repository Variable #
GET /repos/{owner}/{repo}/actions/workflows GitHub List Repository Workflows #
GET /repos/{owner}/{repo}/actions/workflows/{workflow_id} GitHub Get a Workflow #
PUT /repos/{owner}/{repo}/actions/workflows/{workflow_id}/disable GitHub Disable a Workflow #
POST /repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches GitHub Create a Workflow Dispatch Event #
PUT /repos/{owner}/{repo}/actions/workflows/{workflow_id}/enable GitHub Enable a Workflow #
GET /repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs GitHub List Workflow Runs for a Workflow #
GET /repos/{owner}/{repo}/environments/{environment_name}/secrets GitHub List Environment Secrets #
GET /repos/{owner}/{repo}/environments/{environment_name}/secrets/public-key GitHub Get an Environment Public Key #
GET /repos/{owner}/{repo}/environments/{environment_name}/secrets/{secret_name} GitHub Get an Environment Secret #
PUT /repos/{owner}/{repo}/environments/{environment_name}/secrets/{secret_name} GitHub Create or Update an Environment Secret #
DELETE /repos/{owner}/{repo}/environments/{environment_name}/secrets/{secret_name} GitHub Delete an Environment Secret #
GET /repos/{owner}/{repo}/environments/{environment_name}/variables GitHub List Environment Variables #
POST /repos/{owner}/{repo}/environments/{environment_name}/variables GitHub Create an Environment Variable #
GET /repos/{owner}/{repo}/environments/{environment_name}/variables/{name} GitHub Get an Environment Variable #
PATCH /repos/{owner}/{repo}/environments/{environment_name}/variables/{name} GitHub Update an Environment Variable #
DELETE /repos/{owner}/{repo}/environments/{environment_name}/variables/{name} GitHub Delete an Environment Variable #

Documentation

📖
Documentation
https://docs.github.com/en/rest/apps
📖
Documentation
https://docs.github.com/en/rest/codes-of-conduct/codes-of-conduct
📖
Documentation
https://docs.github.com/en/rest/emojis
📖
Documentation
https://docs.github.com/en/rest/gitignore
📖
Documentation
https://docs.github.com/en/rest/apps/installations
📖
Documentation
https://docs.github.com/en/rest/enterprise-admin
📖
Documentation
https://docs.github.com/en/rest/activity/events
📖
Documentation
https://docs.github.com/en/rest/orgs
📖
Documentation
https://docs.github.com/en/rest/rate-limit
📖
Documentation
https://docs.github.com/en/enterprise-cloud@latest/rest/scim
📖
Documentation
https://docs.github.com/en/rest/using-the-rest-api/getting-started-with-the-rest-api
📖
Documentation
https://docs.github.com/en/rest/teams
📖
Documentation
https://docs.github.com/en/rest/meta/meta
📖
Documentation
https://docs.github.com/en/rest/actions
📖
Documentation
https://docs.github.com/en/rest/branches
📖
Documentation
https://docs.github.com/en/rest/code-scanning
📖
Documentation
https://docs.github.com/en/rest/collaborators
📖
Documentation
https://docs.github.com/en/rest/dependabot
📖
Documentation
https://docs.github.com/en/rest/webhooks
📖
Documentation
https://docs.github.com/en/rest/pulls
📖
Documentation
https://docs.github.com/en/rest/git/tags
📖
Documentation
https://docs.github.com/en/rest/repos/autolinks
📖
Documentation
https://docs.github.com/en/rest/collaborators/invitations

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/openapi/github-actions-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/asyncapi/github-webhooks-asyncapi.yml

Other Resources

🔗
Reference
https://docs.github.com/en/webhooks/webhook-events-and-payloads

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/github-actions-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

github-actions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.1.4
  title: GitHub v3 REST Actions API
  description: GitHub's v3 REST API.
  license:
    name: MIT
    url: https://spdx.org/licenses/MIT
  termsOfService: https://docs.github.com/articles/github-terms-of-service
  contact:
    name: Support
    url: https://support.github.com/contact?tags=dotcom-rest-api
  x-github-plan: ghes
  x-github-release: 3.9
servers:
- url: '{protocol}://{hostname}/api/v3'
  variables:
    hostname:
      description: Self-hosted Enterprise Server hostname
      default: HOSTNAME
    protocol:
      description: Self-hosted Enterprise Server protocol
      default: http
tags:
- name: Actions
  description: Endpoints to manage GitHub Actions using the REST API.
paths:
  /enterprises/{enterprise}/actions/cache/usage:
    get:
      summary: GitHub Get GitHub Actions Cache Usage for an Enterprise
      description: 'Gets the total GitHub Actions cache usage for an enterprise.

        The data fetched using this API is refreshed approximately every 5 minutes, so values returned from this endpoint may take at least 5 minutes to get updated.


        OAuth tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint.'
      operationId: actions/get-actions-cache-usage-for-enterprise
      tags:
      - Actions
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/cache#get-github-actions-cache-usage-for-an-enterprise
      parameters:
      - $ref: '#/components/parameters/enterprise'
      responses:
        '200':
          description: Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/actions-cache-usage-org-enterprise'
              examples:
                default:
                  $ref: '#/components/examples/actions-cache-usage-org-enterprise'
          headers:
            Link:
              $ref: '#/components/headers/link'
      x-github:
        enabledForGitHubApps: false
        githubCloudOnly: true
        category: actions
        subcategory: cache
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /enterprises/{enterprise}/actions/cache/usage-policy:
    get:
      summary: GitHub Get GitHub Actions Cache Usage Policy for an Enterprise
      description: 'Gets the GitHub Actions cache usage policy for an enterprise.


        OAuth tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint.'
      tags:
      - Actions
      operationId: actions/get-actions-cache-usage-policy-for-enterprise
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/cache#get-github-actions-cache-usage-policy-for-an-enterprise
      parameters:
      - $ref: '#/components/parameters/enterprise'
      responses:
        '200':
          description: Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/actions-cache-usage-policy-enterprise'
              examples:
                default:
                  $ref: '#/components/examples/actions-cache-usage-policy-enterprise'
          headers:
            Link:
              $ref: '#/components/headers/link'
      x-github:
        enabledForGitHubApps: false
        githubCloudOnly: false
        category: actions
        subcategory: cache
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    patch:
      summary: GitHub Set GitHub Actions Cache Usage Policy for an Enterprise
      description: 'Sets the GitHub Actions cache usage policy for an enterprise.


        OAuth app tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint.'
      tags:
      - Actions
      operationId: actions/set-actions-cache-usage-policy-for-enterprise
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/cache#set-github-actions-cache-usage-policy-for-an-enterprise
      parameters:
      - $ref: '#/components/parameters/enterprise'
      responses:
        '204':
          description: Response
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/actions-cache-usage-policy-enterprise'
            examples:
              selected_actions:
                $ref: '#/components/examples/actions-cache-usage-policy-enterprise'
      x-github:
        enabledForGitHubApps: false
        githubCloudOnly: false
        category: actions
        subcategory: cache
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /enterprises/{enterprise}/actions/permissions/workflow:
    get:
      summary: GitHub Get Default Workflow Permissions for an Enterprise
      description: 'Gets the default workflow permissions granted to the `GITHUB_TOKEN` when running workflows in an enterprise,

        as well as whether GitHub Actions can submit approving pull request reviews. For more information, see

        "[Enforcing a policy for workflow permissions in your enterprise](https://docs.github.com/enterprise-server@3.9/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-workflow-permissions-in-your-enterprise)."


        OAuth tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint.'
      tags:
      - Actions
      operationId: actions/get-github-actions-default-workflow-permissions-enterprise
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/permissions#get-default-workflow-permissions-for-an-enterprise
      parameters:
      - $ref: '#/components/parameters/enterprise'
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/actions-get-default-workflow-permissions'
              examples:
                default:
                  $ref: '#/components/examples/actions-default-workflow-permissions'
      x-github:
        githubCloudOnly: true
        enabledForGitHubApps: false
        category: actions
        subcategory: permissions
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      summary: GitHub Set Default Workflow Permissions for an Enterprise
      description: 'Sets the default workflow permissions granted to the `GITHUB_TOKEN` when running workflows in an enterprise, and sets

        whether GitHub Actions can submit approving pull request reviews. For more information, see

        "[Enforcing a policy for workflow permissions in your enterprise](https://docs.github.com/enterprise-server@3.9/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-workflow-permissions-in-your-enterprise)."


        OAuth app tokens and personal access tokens (classic) need the `admin:enterprise` scope to use this endpoint.'
      tags:
      - Actions
      operationId: actions/set-github-actions-default-workflow-permissions-enterprise
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/permissions#set-default-workflow-permissions-for-an-enterprise
      parameters:
      - $ref: '#/components/parameters/enterprise'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/actions-set-default-workflow-permissions'
            examples:
              default:
                $ref: '#/components/examples/actions-default-workflow-permissions'
      responses:
        '204':
          description: Success response
      x-github:
        githubCloudOnly: true
        enabledForGitHubApps: false
        category: actions
        subcategory: permissions
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /orgs/{org}/actions/cache/usage:
    get:
      summary: GitHub Get GitHub Actions Cache Usage for an Organization
      description: 'Gets the total GitHub Actions cache usage for an organization.

        The data fetched using this API is refreshed approximately every 5 minutes, so values returned from this endpoint may take at least 5 minutes to get updated.


        OAuth tokens and personal access tokens (classic) need the `read:org` scope to use this endpoint.'
      tags:
      - Actions
      operationId: actions/get-actions-cache-usage-for-org
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/cache#get-github-actions-cache-usage-for-an-organization
      parameters:
      - $ref: '#/components/parameters/org'
      responses:
        '200':
          description: Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/actions-cache-usage-org-enterprise'
              examples:
                default:
                  $ref: '#/components/examples/actions-cache-usage-org-enterprise'
          headers:
            Link:
              $ref: '#/components/headers/link'
      x-github:
        githubCloudOnly: false
        enabledForGitHubApps: true
        category: actions
        subcategory: cache
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /orgs/{org}/actions/cache/usage-by-repository:
    get:
      summary: GitHub List Repositories with GitHub Actions Cache Usage for an Organization
      description: 'Lists repositories and their GitHub Actions cache usage for an organization.

        The data fetched using this API is refreshed approximately every 5 minutes, so values returned from this endpoint may take at least 5 minutes to get updated.


        OAuth tokens and personal access tokens (classic) need the `read:org` scope to use this endpoint.'
      tags:
      - Actions
      operationId: actions/get-actions-cache-usage-by-repo-for-org
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/cache#list-repositories-with-github-actions-cache-usage-for-an-organization
      parameters:
      - $ref: '#/components/parameters/org'
      - $ref: '#/components/parameters/per-page'
      - $ref: '#/components/parameters/page'
      responses:
        '200':
          description: Response
          content:
            application/json:
              schema:
                type: object
                required:
                - total_count
                - repository_cache_usages
                properties:
                  total_count:
                    type: integer
                  repository_cache_usages:
                    type: array
                    items:
                      $ref: '#/components/schemas/actions-cache-usage-by-repository'
              examples:
                default:
                  $ref: '#/components/examples/org-actions-cache-usage-by-repo'
          headers:
            Link:
              $ref: '#/components/headers/link'
      x-github:
        githubCloudOnly: false
        enabledForGitHubApps: true
        category: actions
        subcategory: cache
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /orgs/{org}/actions/permissions:
    get:
      summary: GitHub Get GitHub Actions Permissions for an Organization
      description: 'Gets the GitHub Actions permissions policy for repositories and allowed actions in an organization.


        You must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API.'
      operationId: actions/get-github-actions-permissions-organization
      tags:
      - Actions
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/permissions#get-github-actions-permissions-for-an-organization
      parameters:
      - $ref: '#/components/parameters/org'
      responses:
        '200':
          description: Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/actions-organization-permissions'
              examples:
                default:
                  $ref: '#/components/examples/actions-organization-permissions'
      x-github:
        enabledForGitHubApps: true
        githubCloudOnly: false
        category: actions
        subcategory: permissions
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      summary: GitHub Set GitHub Actions Permissions for an Organization
      description: 'Sets the GitHub Actions permissions policy for repositories and allowed actions in an organization.


        If the organization belongs to an enterprise that has set restrictive permissions at the enterprise level, such as `allowed_actions` to `selected` actions, then you cannot override them for the organization.


        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.'
      operationId: actions/set-github-actions-permissions-organization
      tags:
      - Actions
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/permissions#set-github-actions-permissions-for-an-organization
      parameters:
      - $ref: '#/components/parameters/org'
      responses:
        '204':
          description: Response
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                enabled_repositories:
                  $ref: '#/components/schemas/enabled-repositories'
                allowed_actions:
                  $ref: '#/components/schemas/allowed-actions'
              required:
              - enabled_repositories
            examples:
              default:
                value:
                  enabled_repositories: all
                  allowed_actions: selected
      x-github:
        enabledForGitHubApps: true
        githubCloudOnly: false
        category: actions
        subcategory: permissions
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /orgs/{org}/actions/permissions/repositories:
    get:
      summary: GitHub List Selected Repositories Enabled for GitHub Actions in an Organization
      description: 'Lists the selected repositories that are enabled for GitHub Actions in an organization. To use this endpoint, the organization permission policy for `enabled_repositories` must be configured to `selected`. For more information, see "[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization)."


        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.'
      operationId: actions/list-selected-repositories-enabled-github-actions-organization
      tags:
      - Actions
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/permissions#list-selected-repositories-enabled-for-github-actions-in-an-organization
      parameters:
      - $ref: '#/components/parameters/org'
      - $ref: '#/components/parameters/per-page'
      - $ref: '#/components/parameters/page'
      responses:
        '200':
          description: Response
          content:
            application/json:
              schema:
                type: object
                required:
                - total_count
                - repositories
                properties:
                  total_count:
                    type: number
                  repositories:
                    type: array
                    items:
                      $ref: '#/components/schemas/repository'
              examples:
                default:
                  $ref: '#/components/examples/repository-paginated'
      x-github:
        enabledForGitHubApps: true
        githubCloudOnly: false
        category: actions
        subcategory: permissions
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      summary: GitHub Set Selected Repositories Enabled for GitHub Actions in an Organization
      description: 'Replaces the list of selected repositories that are enabled for GitHub Actions in an organization. To use this endpoint, the organization permission policy for `enabled_repositories` must be configured to `selected`. For more information, see "[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization)."



        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.'
      operationId: actions/set-selected-repositories-enabled-github-actions-organization
      tags:
      - Actions
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/permissions#set-selected-repositories-enabled-for-github-actions-in-an-organization
      parameters:
      - $ref: '#/components/parameters/org'
      responses:
        '204':
          description: Response
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                selected_repository_ids:
                  description: List of repository IDs to enable for GitHub Actions.
                  type: array
                  items:
                    type: integer
                    description: Unique identifier of the repository.
              required:
              - selected_repository_ids
            examples:
              default:
                value:
                  selected_repository_ids:
                  - 32
                  - 42
      x-github:
        enabledForGitHubApps: true
        githubCloudOnly: false
        category: actions
        subcategory: permissions
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /orgs/{org}/actions/permissions/repositories/{repository_id}:
    put:
      summary: GitHub Enable a Selected Repository for GitHub Actions in an Organization
      description: 'Adds a repository to the list of selected repositories that are enabled for GitHub Actions in an organization. To use this endpoint, the organization permission policy for `enabled_repositories` must be must be configured to `selected`. For more information, see "[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization)."


        OAuth tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.'
      operationId: actions/enable-selected-repository-github-actions-organization
      tags:
      - Actions
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/permissions#enable-a-selected-repository-for-github-actions-in-an-organization
      parameters:
      - $ref: '#/components/parameters/org'
      - $ref: '#/components/parameters/repository-id'
      responses:
        '204':
          description: Response
      x-github:
        enabledForGitHubApps: true
        githubCloudOnly: false
        category: actions
        subcategory: permissions
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      summary: GitHub Disable a Selected Repository for GitHub Actions in an Organization
      description: 'Removes a repository from the list of selected repositories that are enabled for GitHub Actions in an organization. To use this endpoint, the organization permission policy for `enabled_repositories` must be configured to `selected`. For more information, see "[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization)."


        OAuth tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.'
      operationId: actions/disable-selected-repository-github-actions-organization
      tags:
      - Actions
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/permissions#disable-a-selected-repository-for-github-actions-in-an-organization
      parameters:
      - $ref: '#/components/parameters/org'
      - $ref: '#/components/parameters/repository-id'
      responses:
        '204':
          description: Response
      x-github:
        enabledForGitHubApps: true
        githubCloudOnly: false
        category: actions
        subcategory: permissions
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /orgs/{org}/actions/permissions/selected-actions:
    get:
      summary: GitHub Get Allowed Actions for an Organization
      description: 'Gets the selected actions that are allowed in an organization. To use this endpoint, the organization permission policy for `allowed_actions` must be configured to `selected`. For more information, see "[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization).""


        You must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API.'
      operationId: actions/get-allowed-actions-organization
      tags:
      - Actions
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/permissions#get-allowed-actions-and-reusable-workflows-for-an-organization
      parameters:
      - $ref: '#/components/parameters/org'
      responses:
        '200':
          description: Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/selected-actions'
              examples:
                default:
                  $ref: '#/components/examples/selected-actions'
      x-github:
        enabledForGitHubApps: true
        githubCloudOnly: false
        category: actions
        subcategory: permissions
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      summary: GitHub Set Allowed Actions for an Organization
      description: 'Sets the actions that are allowed in an organization. To use this endpoint, the organization permission policy for `allowed_actions` must be configured to `selected`. For more information, see "[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization)."


        If the organization belongs to an enterprise that has `selected` actions set at the enterprise level, then you cannot override any of the enterprise''s allowed actions settings.


        To use the `patterns_allowed` setting for private repositories, the organization must belong to an enterprise. If the organization does not belong to an enterprise, then the `patterns_allowed` setting only applies to public repositories in the organization.


        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.'
      operationId: actions/set-allowed-actions-organization
      tags:
      - Actions
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/permissions#set-allowed-actions-and-reusable-workflows-for-an-organization
      parameters:
      - $ref: '#/components/parameters/org'
      responses:
        '204':
          description: Response
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/selected-actions'
            examples:
              selected_actions:
                $ref: '#/components/examples/selected-actions'
      x-github:
        enabledForGitHubApps: true
        githubCloudOnly: false
        category: actions
        subcategory: permissions
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /orgs/{org}/actions/permissions/workflow:
    get:
      summary: GitHub Get Default Workflow Permissions for an Organization
      description: 'Gets the default workflow permissions granted to the `GITHUB_TOKEN` when running workflows in an organization,

        as well as whether GitHub Actions can submit approving pull request reviews. For more information, see

        "[Setting the permissions of the GITHUB_TOKEN for your organization](https://docs.github.com/enterprise-server@3.9/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#setting-the-permissions-of-the-github_token-for-your-organization)."


        OAuth tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.'
      tags:
      - Actions
      operationId: actions/get-github-actions-default-workflow-permissions-organization
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/permissions#get-default-workflow-permissions-for-an-organization
      parameters:
      - $ref: '#/components/parameters/org'
      responses:
        '200':
          description: Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/actions-get-default-workflow-permissions'
              examples:
                default:
                  $ref: '#/components/examples/actions-default-workflow-permissions'
      x-github:
        githubCloudOnly: false
        enabledForGitHubApps: true
        category: actions
        subcategory: permissions
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      summary: GitHub Set Default Workflow Permissions for an Organization
      description: 'Sets the default workflow permissions granted to the `GITHUB_TOKEN` when running workflows in an organization, and sets if GitHub Actions

        can submit approving pull request reviews. For more information, see

        "[Setting the permissions of the GITHUB_TOKEN for your organization](https://docs.github.com/enterprise-server@3.9/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#setting-the-permissions-of-the-github_token-for-your-organization)."


        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.'
      tags:
      - Actions
      operationId: actions/set-github-actions-default-workflow-permissions-organization
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/permissions#set-default-workflow-permissions-for-an-organization
      parameters:
      - $ref: '#/components/parameters/org'
      responses:
        '204':
          description: Success response
        '409':
          description: Conflict response when changing a setting is prevented by the owning enterprise
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/actions-set-default-workflow-permissions'
            examples:
              default:
                $ref: '#/components/examples/actions-default-workflow-permissions'
      x-github:
        githubCloudOnly: false
        enabledForGitHubApps: true
        category: actions
        subcategory: permissions
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /orgs/{org}/actions/runner-groups:
    get:
      summary: GitHub List Self-hosted Runner Groups for an Organization
      description: 'Lists all self-hosted runner groups configured in an organization and inherited from an enterprise.


        OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.'
      operationId: actions/list-self-hosted-runner-groups-for-org
      tags:
      - Actions
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/self-hosted-runner-groups#list-self-hosted-runner-groups-for-an-organization
      parameters:
      - $ref: '#/components/parameters/org'
      - $ref: '#/components/parameters/per-page'
      - $ref: '#/components/parameters/page'
      - $ref: '#/components/parameters/visible-to-repository'
      responses:
        '200':
          description: Response
          content:
            application/json:
              schema:
                type: object
                required:
                - total_count
                - runner_groups
                properties:
                  total_count:
                    type: number
                  runner_groups:
                    type: array
                    items:
                      $ref: '#/components/schemas/runner-groups-org'
              examples:
                default:
                  $ref: '#/components/examples/runner-groups-org'
      x-github:
        enabledForGitHubApps: true
        githubCloudOnly: true
        category: actions
        subcategory: self-hosted-runner-groups
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      summary: GitHub Create a Self-hosted Runner Group for an Organization
      description: 'Creates a new self-hosted runner group for an organization.


        OAuth tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.'
      operationId: actions/create-self-hosted-runner-group-for-org
      tags:
      - Actions
      externalDocs:
        description: API method documentation
        url: https://docs.github.com/enterprise-server@3.9/rest/actions/self-hosted-runner-groups#create-a-self-hosted-runner-group-for-an-organization
      parameters:
      - $ref: '#/components/parameters/org'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  description: Name of the runner group.
                  type: string
                visibility:
                  description: Visibility of a runner group. You can select all repositories, select individual repositories, or limit access to private repositories.
                  type: string
                  enum:
                  - selected
                  - all
                  - private
                  default: all
                selected_repository_ids:
                  description: List of repository IDs that can access the runner group.
                  type: array
                  items:
                    type: integer
                    description: Unique identifier of the repository.
                runners:
                  description: List of runner IDs to add to the runner group.
                  type: array
                  items:
                    type: integer
                    description: Unique identifier of the runner.
                allows_public_repositories:
                  description: Whether the runner group can be used by `public` repositories.
                  type: boolean
                  default: false
                restricted_to_workflows:
                  description: If `true`, the runner group will be restricted to running only the workflows specified in the `selected_workflows` array.
                  type: boolean
                  default: false
                selected_workflows:
                  description: List of workflows the runner group should be allowed to run. This setting will be ignored unless `restricted_to_workflows` is set to `true`.
                  type: array
                  items:
                    type: string
             

# --- truncated at 32 KB (409 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/openapi/github-actions-api-openapi.yml