Endpoints to manage GitHub Actions using the REST API.

Get GitHub Actions cache usage for an enterprise

get /enterprises/{enterprise}/actions/cache/usage

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. You must authenticate using an access token with the admin:enterprise scope to use this endpoint.

enterprise

string

required

The slug version of the enterprise name. You can also substitute this value with the enterprise id.

Response

Examples Schema

Response

{
  "total_active_caches_size_in_bytes": 3344284,
  "total_active_caches_count": 5
}

total_active_caches_count

int

required

The count of active caches across all repositories of an enterprise or an organization.

total_active_caches_size_in_bytes

int

required

The total size in bytes of all active cache items across all repositories of an enterprise or an organization.

Link

string

Get GitHub Actions cache usage policy for an enterprise

get /enterprises/{enterprise}/actions/cache/usage-policy

Gets the GitHub Actions cache usage policy for an enterprise. You must authenticate using an access token with the admin:enterprise scope to use this endpoint.

enterprise

string

required

The slug version of the enterprise name. You can also substitute this value with the enterprise id.

Response

Examples Schema

Response

{
  "repo_cache_size_limit_in_gb": 10,
  "max_repo_cache_size_limit_in_gb": 15
}

repo_cache_size_limit_in_gb

int

For repositories in an enterprise, the default size limit for the sum of all caches in a repository, in gigabytes.

Example
10

max_repo_cache_size_limit_in_gb

int

For repositories in an enterprise, the maximum value that can be set as the limit for the sum of all caches in a repository, in gigabytes.

Example
15

Link

string

Set GitHub Actions cache usage policy for an enterprise

patch /enterprises/{enterprise}/actions/cache/usage-policy

Sets the GitHub Actions cache usage policy for an enterprise. You must authenticate using an access token with the admin:enterprise scope to use this endpoint.

enterprise

string

required

The slug version of the enterprise name. You can also substitute this value with the enterprise id.

repo_cache_size_limit_in_gb

int

For repositories in an enterprise, the default size limit for the sum of all caches in a repository, in gigabytes.

Example
10

max_repo_cache_size_limit_in_gb

int

For repositories in an enterprise, the maximum value that can be set as the limit for the sum of all caches in a repository, in gigabytes.

Example
15

Request

{
  "repo_cache_size_limit_in_gb": 10,
  "max_repo_cache_size_limit_in_gb": 15
}

Response

Examples Schema

Response

Empty response

No schema

Get default workflow permissions for an enterprise

get /enterprises/{enterprise}/actions/permissions/workflow

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."

You must authenticate using an access token with the admin:enterprise scope to use this endpoint.

enterprise

string

required

The slug version of the enterprise name. You can also substitute this value with the enterprise id.

Response

Examples Schema

Success response

{
  "default_workflow_permissions": "read",
  "can_approve_pull_request_reviews": true
}

default_workflow_permissions

string

required

The default workflow permissions granted to the GITHUB_TOKEN when running workflows.

Enum
  • read
  • write

can_approve_pull_request_reviews

boolean

required

Whether GitHub Actions can approve pull requests. Enabling this can be a security risk.

Set default workflow permissions for an enterprise

put /enterprises/{enterprise}/actions/permissions/workflow

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."

You must authenticate using an access token with the admin:enterprise scope to use this endpoint.

enterprise

string

required

The slug version of the enterprise name. You can also substitute this value with the enterprise id.

default_workflow_permissions

string

The default workflow permissions granted to the GITHUB_TOKEN when running workflows.

Enum
  • read
  • write

can_approve_pull_request_reviews

boolean

Whether GitHub Actions can approve pull requests. Enabling this can be a security risk.

Request

{
  "default_workflow_permissions": "read",
  "can_approve_pull_request_reviews": true
}

Response

Examples Schema

Success response

Empty response

No schema

Get GitHub Actions cache usage for an organization

get /orgs/{org}/actions/cache/usage

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. You must authenticate using an access token with the read:org scope to use this endpoint. GitHub Apps must have the organization_admistration:read permission to use this endpoint.

org

string

required

The organization name. The name is not case sensitive.

Response

Examples Schema

Response

{
  "total_active_caches_size_in_bytes": 3344284,
  "total_active_caches_count": 5
}

total_active_caches_count

int

required

The count of active caches across all repositories of an enterprise or an organization.

total_active_caches_size_in_bytes

int

required

The total size in bytes of all active cache items across all repositories of an enterprise or an organization.

Link

string

List repositories with GitHub Actions cache usage for an organization

get /orgs/{org}/actions/cache/usage-by-repository

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. You must authenticate using an access token with the read:org scope to use this endpoint. GitHub Apps must have the organization_admistration:read permission to use this endpoint.

org

string

required

The organization name. The name is not case sensitive.

per_page

int

The number of results per page (max 100).

Default
30

page

int

Page number of the results to fetch.

Default
1

Response

Examples Schema

Response

{
  "total_count": 2,
  "repository_cache_usages": [
    {
      "full_name": "octo-org/Hello-World",
      "active_caches_size_in_bytes": 2322142,
      "active_caches_count": 3
    },
    {
      "full_name": "octo-org/server",
      "active_caches_size_in_bytes": 1022142,
      "active_caches_count": 2
    }
  ]
}

total_count

int

required

repository_cache_usages

array[object (Actions Cache Usage by repository)]

required

Actions Cache Usage by repository

object (Actions Cache Usage by repository)

GitHub Actions Cache Usage by repository.

full_name

string

required

The repository owner and name for the cache usage being shown.

Example
"octo-org/Hello-World"

active_caches_size_in_bytes

int

required

The sum of the size in bytes of all the active cache items in the repository.

Example
2322142

active_caches_count

int

required

The number of active caches in the repository.

Example
3

Link

string

Get GitHub Actions permissions for an organization

get /orgs/{org}/actions/permissions

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.

org

string

required

The organization name. The name is not case sensitive.

Response

Examples Schema

Response

{
  "enabled_repositories": "all",
  "allowed_actions": "selected",
  "selected_actions_url": "https://api.github.com/organizations/42/actions/permissions/selected-actions"
}

enabled_repositories

string

required

The policy that controls the repositories in the organization that are allowed to run GitHub Actions.

Enum
  • all
  • none
  • selected

selected_repositories_url

string

The API URL to use to get or set the selected repositories that are allowed to run GitHub Actions, when enabled_repositories is set to selected.

allowed_actions

string

The permissions policy that controls the actions that are allowed to run.

Enum
  • all
  • local_only
  • selected

selected_actions_url

string

The API URL to use to get or set the actions that are allowed to run, when allowed_actions is set to selected.

Set GitHub Actions permissions for an organization

put /orgs/{org}/actions/permissions

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.

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.

org

string

required

The organization name. The name is not case sensitive.

enabled_repositories

string

required

The policy that controls the repositories in the organization that are allowed to run GitHub Actions.

Enum
  • all
  • none
  • selected

allowed_actions

string

The permissions policy that controls the actions that are allowed to run.

Enum
  • all
  • local_only
  • selected

Request

{
  "enabled_repositories": "all",
  "allowed_actions": "selected"
}

Response

Examples Schema

Response

Empty response

No schema

List selected repositories enabled for GitHub Actions in an organization

get /orgs/{org}/actions/permissions/repositories

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."

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.

org

string

required

The organization name. The name is not case sensitive.

per_page

int

The number of results per page (max 100).

Default
30

page

int

Page number of the results to fetch.

Default
1

Response

Examples Schema

Response

{
  "total_count": 1,
  "repositories": [
    {
      "id": 1296269,
      "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5",
      "name": "Hello-World",
      "full_name": "octocat/Hello-World",
      "owner": {
        "login": "octocat",
        "id": 1,
        "node_id": "MDQ6VXNlcjE=",
        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
        "gravatar_id": "",
        "url": "https://api.github.com/users/octocat",
        "html_url": "https://github.com/octocat",
        "followers_url": "https://api.github.com/users/octocat/followers",
        "following_url": "https://api.github.com/users/octocat/following{/other_user}",
        "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
        "organizations_url": "https://api.github.com/users/octocat/orgs",
        "repos_url": "https://api.github.com/users/octocat/repos",
        "events_url": "https://api.github.com/users/octocat/events{/privacy}",
        "received_events_url": "https://api.github.com/users/octocat/received_events",
        "type": "User",
        "site_admin": false
      },
      "private": false,
      "html_url": "https://github.com/octocat/Hello-World",
      "description": "This your first repo!",
      "fork": false,
      "url": "https://api.github.com/repos/octocat/Hello-World",
      "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
      "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}",
      "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
      "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}",
      "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
      "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}",
      "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}",
      "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
      "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}",
      "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors",
      "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments",
      "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads",
      "events_url": "https://api.github.com/repos/octocat/Hello-World/events",
      "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks",
      "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
      "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
      "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
      "git_url": "git:github.com/octocat/Hello-World.git",
      "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
      "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
      "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}",
      "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
      "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}",
      "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages",
      "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges",
      "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}",
      "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
      "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}",
      "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}",
      "ssh_url": "git@github.com:octocat/Hello-World.git",
      "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers",
      "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
      "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers",
      "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription",
      "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags",
      "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams",
      "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
      "clone_url": "https://github.com/octocat/Hello-World.git",
      "mirror_url": "git:git.example.com/octocat/Hello-World",
      "hooks_url": "https://api.github.com/repos/octocat/Hello-World/hooks",
      "svn_url": "https://svn.github.com/octocat/Hello-World",
      "homepage": "https://github.com",
      "language": null,
      "forks_count": 9,
      "stargazers_count": 80,
      "watchers_count": 80,
      "size": 108,
      "default_branch": "master",
      "open_issues_count": 0,
      "is_template": true,
      "topics": [
        "octocat",
        "atom",
        "electron",
        "api"
      ],
      "has_issues": true,
      "has_projects": true,
      "has_wiki": true,
      "has_pages": false,
      "has_downloads": true,
      "archived": false,
      "disabled": false,
      "visibility": "public",
      "pushed_at": "2011-01-26T19:06:43Z",
      "created_at": "2011-01-26T19:01:12Z",
      "updated_at": "2011-01-26T19:14:43Z",
      "permissions": {
        "admin": false,
        "push": false,
        "pull": true
      },
      "allow_rebase_merge": true,
      "template_repository": null,
      "temp_clone_token": "ABTLWHOULUVAXGTRYU7OC2876QJ2O",
      "allow_squash_merge": true,
      "allow_auto_merge": false,
      "delete_branch_on_merge": true,
      "allow_merge_commit": true,
      "subscribers_count": 42,
      "network_count": 0,
      "license": {
        "key": "mit",
        "name": "MIT License",
        "url": "https://api.github.com/licenses/mit",
        "spdx_id": "MIT",
        "node_id": "MDc6TGljZW5zZW1pdA==",
        "html_url": "https://github.com/licenses/mit"
      },
      "forks": 1,
      "open_issues": 1,
      "watchers": 1
    }
  ]
}

total_count

number

required

repositories

array[object (Repository)]

required

Repository

object (Repository)

A repository on GitHub.

id

int

required

Unique identifier of the repository

Example
42

node_id

string

required

Example
"MDEwOlJlcG9zaXRvcnkxMjk2MjY5"

name

string

required

The name of the repository.

Example
"Team Environment"

full_name

string

required

Example
"octocat/Hello-World"

license

object (license) or null

required

License Simple

key

string

required

Example
"mit"

name

string

required

Example
"MIT License"

url

string or null

uri

required

Example
"https://api.github.com/licenses/mit"

spdx_id

string or null

required

Example
"MIT"

node_id

string

required

Example
"MDc6TGljZW5zZW1pdA=="

html_url

string

uri

organization

object (organization) or null

A GitHub user.

name

string or null

email

string or null

login

string

required

Example
"octocat"

id

int

required

Example
1

node_id

string

required

Example
"MDQ6VXNlcjE="

avatar_url

string

uri

required

Example
"https://github.com/images/error/octocat_happy.gif"

gravatar_id

string or null

required

Example
"41d064eb2195891e12d0413f63227ea7"

url

string

uri

required

Example
"https://api.github.com/users/octocat"

html_url

string

uri

required

Example
"https://github.com/octocat"

followers_url

string

uri

required

Example
"https://api.github.com/users/octocat/followers"

following_url

string

required

Example
"https://api.github.com/users/octocat/following{/other_user}"

gists_url

string

required

Example
"https://api.github.com/users/octocat/gists{/gist_id}"

starred_url

string

required

Example
"https://api.github.com/users/octocat/starred{/owner}{/repo}"

subscriptions_url

string

uri

required

Example
"https://api.github.com/users/octocat/subscriptions"

organizations_url

string

uri

required

Example
"https://api.github.com/users/octocat/orgs"

repos_url

string

uri

required

Example
"https://api.github.com/users/octocat/repos"

events_url

string

required

Example
"https://api.github.com/users/octocat/events{/privacy}"

received_events_url

string

uri

required

Example
"https://api.github.com/users/octocat/received_events"

type

string

required

Example
"User"

site_admin

boolean

required

starred_at

string

Example
"\"2020-07-09T00:17:55Z\""

forks

int

required

permissions

object (permissions)

admin

boolean

required

pull

boolean

required

triage

boolean

push

boolean

required

maintain

boolean

owner

object (owner)

required

A GitHub user.

name

string or null

email

string or null

login

string

required

Example
"octocat"

id

int

required

Example
1

node_id

string

required

Example
"MDQ6VXNlcjE="

avatar_url

string

uri

required

Example
"https://github.com/images/error/octocat_happy.gif"

gravatar_id

string or null

required

Example
"41d064eb2195891e12d0413f63227ea7"

url

string

uri

required

Example
"https://api.github.com/users/octocat"

html_url

string

uri

required

Example
"https://github.com/octocat"

followers_url

string

uri

required

Example
"https://api.github.com/users/octocat/followers"

following_url

string

required

Example
"https://api.github.com/users/octocat/following{/other_user}"

gists_url

string

required

Example
"https://api.github.com/users/octocat/gists{/gist_id}"

starred_url

string

required

Example
"https://api.github.com/users/octocat/starred{/owner}{/repo}"

subscriptions_url

string

uri

required

Example
"https://api.github.com/users/octocat/subscriptions"

organizations_url

string

uri

required

Example
"https://api.github.com/users/octocat/orgs"

repos_url

string

uri

required

Example
"https://api.github.com/users/octocat/repos"

events_url

string

required

Example
"https://api.github.com/users/octocat/events{/privacy}"

received_events_url

string

uri

required

Example
"https://api.github.com/users/octocat/received_events"

type

string

required

Example
"User"

site_admin

boolean

required

starred_at

string

Example
"\"2020-07-09T00:17:55Z\""

private

boolean

required

Whether the repository is private or public.

Default
false

html_url

string

uri

required

Example
"https://github.com/octocat/Hello-World"

description

string or null

required

Example
"This your first repo!"

fork

boolean

required

url

string

uri

required

Example
"https://api.github.com/repos/octocat/Hello-World"

archive_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}"

assignees_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/assignees{/user}"

blobs_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}"

branches_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/branches{/branch}"

collaborators_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}"

comments_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/comments{/number}"

commits_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/commits{/sha}"

compare_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}"

contents_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/contents/{+path}"

contributors_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/contributors"

deployments_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/deployments"

downloads_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/downloads"

events_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/events"

forks_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/forks"

git_commits_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}"

git_refs_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}"

git_tags_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}"

git_url

string

required

Example
"git:github.com/octocat/Hello-World.git"

issue_comment_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}"

issue_events_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/issues/events{/number}"

issues_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/issues{/number}"

keys_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/keys{/key_id}"

labels_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/labels{/name}"

languages_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/languages"

merges_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/merges"

milestones_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/milestones{/number}"

notifications_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}"

pulls_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/pulls{/number}"

releases_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/releases{/id}"

ssh_url

string

required

Example
"git@github.com:octocat/Hello-World.git"

stargazers_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/stargazers"

statuses_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/statuses/{sha}"

subscribers_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/subscribers"

subscription_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/subscription"

tags_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/tags"

teams_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/teams"

trees_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}"

clone_url

string

required

Example
"https://github.com/octocat/Hello-World.git"

mirror_url

string or null

uri

required

Example
"git:git.example.com/octocat/Hello-World"

hooks_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/hooks"

svn_url

string

uri

required

Example
"https://svn.github.com/octocat/Hello-World"

homepage

string or null

uri

required

Example
"https://github.com"

language

string or null

required

forks_count

int

required

Example
9

stargazers_count

int

required

Example
80

watchers_count

int

required

Example
80

size

int

required

The size of the repository. Size is calculated hourly. When a repository is initially created, the size is 0.

Example
108

default_branch

string

required

The default branch of the repository.

Example
"master"

open_issues_count

int

required

Example
0

is_template

boolean

Whether this repository acts as a template that can be used to generate new repositories.

Default
false
Example
true

topics

array[string]

string

has_issues

boolean

required

Whether issues are enabled.

Default
true
Example
true

has_projects

boolean

required

Whether projects are enabled.

Default
true
Example
true

has_wiki

boolean

required

Whether the wiki is enabled.

Default
true
Example
true

has_pages

boolean

required

has_downloads

boolean

required

Whether downloads are enabled.

Default
true
Example
true

has_discussions

boolean

Whether discussions are enabled.

Default
false
Example
true

archived

boolean

required

Whether the repository is archived.

Default
false

disabled

boolean

required

Returns whether or not this repository disabled.

visibility

string

The repository visibility: public, private, or internal.

Default
"public"

pushed_at

string or null

date-time

required

Example
"2011-01-26T19:06:43Z"

created_at

string or null

date-time

required

Example
"2011-01-26T19:01:12Z"

updated_at

string or null

date-time

required

Example
"2011-01-26T19:14:43Z"

allow_rebase_merge

boolean

Whether to allow rebase merges for pull requests.

Default
true
Example
true

template_repository

object (template_repository) or null

id

int

node_id

string

name

string

full_name

string

owner

object (owner)

login

string

id

int

node_id

string

avatar_url

string

gravatar_id

string

url

string

html_url

string

followers_url

string

following_url

string

gists_url

string

starred_url

string

subscriptions_url

string

organizations_url

string

repos_url

string

events_url

string

received_events_url

string

type

string

site_admin

boolean

private

boolean

html_url

string

description

string

fork

boolean

url

string

archive_url

string

assignees_url

string

blobs_url

string

branches_url

string

collaborators_url

string

comments_url

string

commits_url

string

compare_url

string

contents_url

string

contributors_url

string

deployments_url

string

downloads_url

string

events_url

string

forks_url

string

git_commits_url

string

git_refs_url

string

git_tags_url

string

git_url

string

issue_comment_url

string

issue_events_url

string

issues_url

string

keys_url

string

labels_url

string

languages_url

string

merges_url

string

milestones_url

string

notifications_url

string

pulls_url

string

releases_url

string

ssh_url

string

stargazers_url

string

statuses_url

string

subscribers_url

string

subscription_url

string

tags_url

string

teams_url

string

trees_url

string

clone_url

string

mirror_url

string

hooks_url

string

svn_url

string

homepage

string

language

string

forks_count

int

stargazers_count

int

watchers_count

int

size

int

default_branch

string

open_issues_count

int

is_template

boolean

topics

array[string]

string

has_issues

boolean

has_projects

boolean

has_wiki

boolean

has_pages

boolean

has_downloads

boolean

archived

boolean

disabled

boolean

visibility

string

pushed_at

string

created_at

string

updated_at

string

permissions

object (permissions)

admin

boolean

maintain

boolean

push

boolean

triage

boolean

pull

boolean

allow_rebase_merge

boolean

temp_clone_token

string

allow_squash_merge

boolean

allow_auto_merge

boolean

delete_branch_on_merge

boolean

allow_update_branch

boolean

use_squash_pr_title_as_default

boolean

squash_merge_commit_title

string

The default value for a squash merge commit title:

  • PR_TITLE - default to the pull request's title.
  • COMMIT_OR_PR_TITLE - default to the commit's title (if only one commit) or the pull request's title (when more than one commit).
Enum
  • PR_TITLE
  • COMMIT_OR_PR_TITLE

squash_merge_commit_message

string

The default value for a squash merge commit message:

  • PR_BODY - default to the pull request's body.
  • COMMIT_MESSAGES - default to the branch's commit messages.
  • BLANK - default to a blank commit message.
Enum
  • PR_BODY
  • COMMIT_MESSAGES
  • BLANK

merge_commit_title

string

The default value for a merge commit title.

  • PR_TITLE - default to the pull request's title.
  • MERGE_MESSAGE - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name).
Enum
  • PR_TITLE
  • MERGE_MESSAGE

merge_commit_message

string

The default value for a merge commit message.

  • PR_TITLE - default to the pull request's title.
  • PR_BODY - default to the pull request's body.
  • BLANK - default to a blank commit message.
Enum
  • PR_BODY
  • PR_TITLE
  • BLANK

allow_merge_commit

boolean

subscribers_count

int

network_count

int

temp_clone_token

string

allow_squash_merge

boolean

Whether to allow squash merges for pull requests.

Default
true
Example
true

allow_auto_merge

boolean

Whether to allow Auto-merge to be used on pull requests.

Default
false
Example
false

delete_branch_on_merge

boolean

Whether to delete head branches when pull requests are merged

Default
false
Example
false

allow_update_branch

boolean

Whether or not a pull request head branch that is behind its base branch can always be updated even if it is not required to be up to date before merging.

Default
false
Example
false

use_squash_pr_title_as_default

boolean

deprecated

Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use squash_merge_commit_title instead.

Default
false

squash_merge_commit_title

string

The default value for a squash merge commit title:

  • PR_TITLE - default to the pull request's title.
  • COMMIT_OR_PR_TITLE - default to the commit's title (if only one commit) or the pull request's title (when more than one commit).
Enum
  • PR_TITLE
  • COMMIT_OR_PR_TITLE

squash_merge_commit_message

string

The default value for a squash merge commit message:

  • PR_BODY - default to the pull request's body.
  • COMMIT_MESSAGES - default to the branch's commit messages.
  • BLANK - default to a blank commit message.
Enum
  • PR_BODY
  • COMMIT_MESSAGES
  • BLANK

merge_commit_title

string

The default value for a merge commit title.

  • PR_TITLE - default to the pull request's title.
  • MERGE_MESSAGE - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name).
Enum
  • PR_TITLE
  • MERGE_MESSAGE

merge_commit_message

string

The default value for a merge commit message.

  • PR_TITLE - default to the pull request's title.
  • PR_BODY - default to the pull request's body.
  • BLANK - default to a blank commit message.
Enum
  • PR_BODY
  • PR_TITLE
  • BLANK

allow_merge_commit

boolean

Whether to allow merge commits for pull requests.

Default
true
Example
true

allow_forking

boolean

Whether to allow forking this repo

web_commit_signoff_required

boolean

Whether to require contributors to sign off on web-based commits

Default
false

subscribers_count

int

network_count

int

open_issues

int

required

watchers

int

required

master_branch

string

starred_at

string

Example
"\"2020-07-09T00:17:42Z\""

anonymous_access_enabled

boolean

Whether anonymous git access is enabled for this repository

Set selected repositories enabled for GitHub Actions in an organization

put /orgs/{org}/actions/permissions/repositories

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."

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.

org

string

required

The organization name. The name is not case sensitive.

selected_repository_ids

array[int]

required

List of repository IDs to enable for GitHub Actions.

int

Unique identifier of the repository.

Request

{
  "selected_repository_ids": [
    32,
    42
  ]
}

Response

Examples Schema

Response

Empty response

No schema

Enable a selected repository for GitHub Actions in an organization

put /orgs/{org}/actions/permissions/repositories/{repository_id}

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."

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.

org

string

required

The organization name. The name is not case sensitive.

repository_id

int

required

The unique identifier of the repository.

Response

Examples Schema

Response

Empty response

No schema

Disable a selected repository for GitHub Actions in an organization

delete /orgs/{org}/actions/permissions/repositories/{repository_id}

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."

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.

org

string

required

The organization name. The name is not case sensitive.

repository_id

int

required

The unique identifier of the repository.

Response

Examples Schema

Response

Empty response

No schema

Get allowed actions for an organization

get /orgs/{org}/actions/permissions/selected-actions

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.""

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.

org

string

required

The organization name. The name is not case sensitive.

Response

Examples Schema

Response

{
  "github_owned_allowed": true,
  "verified_allowed": false,
  "patterns_allowed": [
    "monalisa/octocat@*",
    "docker/*"
  ]
}

github_owned_allowed

boolean

required

Whether GitHub-owned actions are allowed. For example, this includes the actions in the actions organization.

patterns_allowed

array[string]

required

Specifies a list of string-matching patterns to allow specific action(s). Wildcards, tags, and SHAs are allowed. For example, monalisa/octocat@*, monalisa/octocat@v2, monalisa/*.

string

Set allowed actions for an organization

put /orgs/{org}/actions/permissions/selected-actions

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."

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.

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.

org

string

required

The organization name. The name is not case sensitive.

github_owned_allowed

boolean

required

Whether GitHub-owned actions are allowed. For example, this includes the actions in the actions organization.

patterns_allowed

array[string]

required

Specifies a list of string-matching patterns to allow specific action(s). Wildcards, tags, and SHAs are allowed. For example, monalisa/octocat@*, monalisa/octocat@v2, monalisa/*.

string

Request

{
  "github_owned_allowed": true,
  "verified_allowed": false,
  "patterns_allowed": [
    "monalisa/octocat@*",
    "docker/*"
  ]
}

Response

Examples Schema

Response

Empty response

No schema

Get default workflow permissions for an organization

get /orgs/{org}/actions/permissions/workflow

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."

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.

org

string

required

The organization name. The name is not case sensitive.

Response

Examples Schema

Response

{
  "default_workflow_permissions": "read",
  "can_approve_pull_request_reviews": true
}

default_workflow_permissions

string

required

The default workflow permissions granted to the GITHUB_TOKEN when running workflows.

Enum
  • read
  • write

can_approve_pull_request_reviews

boolean

required

Whether GitHub Actions can approve pull requests. Enabling this can be a security risk.

Set default workflow permissions for an organization

put /orgs/{org}/actions/permissions/workflow

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."

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.

org

string

required

The organization name. The name is not case sensitive.

default_workflow_permissions

string

The default workflow permissions granted to the GITHUB_TOKEN when running workflows.

Enum
  • read
  • write

can_approve_pull_request_reviews

boolean

Whether GitHub Actions can approve pull requests. Enabling this can be a security risk.

Request

{
  "default_workflow_permissions": "read",
  "can_approve_pull_request_reviews": true
}

Response

Examples Schema

Success response

Empty response

Conflict response when changing a setting is prevented by the owning enterprise

Empty response

No schema

No schema

List required workflows

get /orgs/{org}/actions/required_workflows

List all required workflows in an organization.

You must authenticate using an access token with the read:org scope to use this endpoint.

For more information, see "Required Workflows."

org

string

required

The organization name. The name is not case sensitive.

per_page

int

The number of results per page (max 100).

Default
30

page

int

Page number of the results to fetch.

Default
1

Response

Examples Schema

Response

{
  "total_count": 2,
  "required_workflows": [
    {
      "id": 30433642,
      "name": "Required CI",
      "path": ".github/workflows/ci.yml",
      "scope": "selected",
      "ref": "refs/head/main",
      "state": "active",
      "selected_repositories_url": "https://api.github.com/organizations/org/actions/required_workflows/1/repositories",
      "created_at": "2020-01-22T19:33:08Z",
      "updated_at": "2020-01-22T19:33:08Z",
      "repository": {
        "id": 1296269,
        "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5",
        "name": "Hello-World",
        "full_name": "octocat/Hello-World",
        "owner": {
          "login": "octocat",
          "id": 1,
          "node_id": "MDQ6VXNlcjE=",
          "avatar_url": "https://github.com/images/error/octocat_happy.gif",
          "gravatar_id": "",
          "url": "https://api.github.com/users/octocat",
          "html_url": "https://github.com/octocat",
          "followers_url": "https://api.github.com/users/octocat/followers",
          "following_url": "https://api.github.com/users/octocat/following{/other_user}",
          "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
          "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
          "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
          "organizations_url": "https://api.github.com/users/octocat/orgs",
          "repos_url": "https://api.github.com/users/octocat/repos",
          "events_url": "https://api.github.com/users/octocat/events{/privacy}",
          "received_events_url": "https://api.github.com/users/octocat/received_events",
          "type": "User",
          "site_admin": false
        },
        "private": false,
        "html_url": "https://github.com/octocat/Hello-World",
        "description": "This your first repo!",
        "fork": false,
        "url": "https://api.github.com/repos/octocat/Hello-World",
        "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
        "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}",
        "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
        "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}",
        "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
        "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}",
        "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}",
        "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
        "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}",
        "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors",
        "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments",
        "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads",
        "events_url": "https://api.github.com/repos/octocat/Hello-World/events",
        "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks",
        "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
        "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
        "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
        "git_url": "git:github.com/octocat/Hello-World.git",
        "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
        "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
        "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}",
        "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
        "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}",
        "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages",
        "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges",
        "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}",
        "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
        "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}",
        "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}",
        "ssh_url": "git@github.com:octocat/Hello-World.git",
        "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers",
        "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
        "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers",
        "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription",
        "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags",
        "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams",
        "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
        "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks"
      }
    },
    {
      "id": 30433643,
      "name": "Required Linter",
      "path": ".github/workflows/lint.yml",
      "scope": "all",
      "ref": "refs/head/main",
      "state": "active",
      "created_at": "2020-01-22T19:33:08Z",
      "updated_at": "2020-01-22T19:33:08Z",
      "repository": {
        "id": 1296269,
        "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5",
        "name": "Hello-World",
        "full_name": "octocat/Hello-World",
        "owner": {
          "login": "octocat",
          "id": 1,
          "node_id": "MDQ6VXNlcjE=",
          "avatar_url": "https://github.com/images/error/octocat_happy.gif",
          "gravatar_id": "",
          "url": "https://api.github.com/users/octocat",
          "html_url": "https://github.com/octocat",
          "followers_url": "https://api.github.com/users/octocat/followers",
          "following_url": "https://api.github.com/users/octocat/following{/other_user}",
          "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
          "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
          "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
          "organizations_url": "https://api.github.com/users/octocat/orgs",
          "repos_url": "https://api.github.com/users/octocat/repos",
          "events_url": "https://api.github.com/users/octocat/events{/privacy}",
          "received_events_url": "https://api.github.com/users/octocat/received_events",
          "type": "User",
          "site_admin": false
        },
        "private": false,
        "html_url": "https://github.com/octocat/Hello-World",
        "description": "This your first repo!",
        "fork": false,
        "url": "https://api.github.com/repos/octocat/Hello-World",
        "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
        "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}",
        "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
        "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}",
        "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
        "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}",
        "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}",
        "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
        "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}",
        "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors",
        "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments",
        "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads",
        "events_url": "https://api.github.com/repos/octocat/Hello-World/events",
        "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks",
        "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
        "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
        "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
        "git_url": "git:github.com/octocat/Hello-World.git",
        "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
        "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
        "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}",
        "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
        "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}",
        "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages",
        "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges",
        "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}",
        "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
        "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}",
        "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}",
        "ssh_url": "git@github.com:octocat/Hello-World.git",
        "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers",
        "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
        "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers",
        "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription",
        "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags",
        "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams",
        "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
        "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks"
      }
    }
  ]
}

total_count

int

required

required_workflows

array[object]

required

object

id

number

required

Unique identifier for a required workflow

name

string

required

Name present in the workflow file

path

string

required

Path of the workflow file

scope

string

required

Scope of the required workflow

Enum
  • all
  • selected

ref

string

required

Ref at which the workflow file will be selected

state

string

required

State of the required workflow

Enum
  • active
  • deleted

selected_repositories_url

string

uri

Example
"https://api.github.com/organizations/org/actions/required_workflows/1/repositories"

created_at

string

date-time

required

updated_at

string

date-time

required

repository

object (repository)

required

Minimal Repository

id

int

required

Example
1296269

node_id

string

required

Example
"MDEwOlJlcG9zaXRvcnkxMjk2MjY5"

name

string

required

Example
"Hello-World"

full_name

string

required

Example
"octocat/Hello-World"

owner

object (owner)

required

A GitHub user.

name

string or null

email

string or null

login

string

required

Example
"octocat"

id

int

required

Example
1

node_id

string

required

Example
"MDQ6VXNlcjE="

avatar_url

string

uri

required

Example
"https://github.com/images/error/octocat_happy.gif"

gravatar_id

string or null

required

Example
"41d064eb2195891e12d0413f63227ea7"

url

string

uri

required

Example
"https://api.github.com/users/octocat"

html_url

string

uri

required

Example
"https://github.com/octocat"

followers_url

string

uri

required

Example
"https://api.github.com/users/octocat/followers"

following_url

string

required

Example
"https://api.github.com/users/octocat/following{/other_user}"

gists_url

string

required

Example
"https://api.github.com/users/octocat/gists{/gist_id}"

starred_url

string

required

Example
"https://api.github.com/users/octocat/starred{/owner}{/repo}"

subscriptions_url

string

uri

required

Example
"https://api.github.com/users/octocat/subscriptions"

organizations_url

string

uri

required

Example
"https://api.github.com/users/octocat/orgs"

repos_url

string

uri

required

Example
"https://api.github.com/users/octocat/repos"

events_url

string

required

Example
"https://api.github.com/users/octocat/events{/privacy}"

received_events_url

string

uri

required

Example
"https://api.github.com/users/octocat/received_events"

type

string

required

Example
"User"

site_admin

boolean

required

starred_at

string

Example
"\"2020-07-09T00:17:55Z\""

private

boolean

required

html_url

string

uri

required

Example
"https://github.com/octocat/Hello-World"

description

string or null

required

Example
"This your first repo!"

fork

boolean

required

url

string

uri

required

Example
"https://api.github.com/repos/octocat/Hello-World"

archive_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}"

assignees_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/assignees{/user}"

blobs_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}"

branches_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/branches{/branch}"

collaborators_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}"

comments_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/comments{/number}"

commits_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/commits{/sha}"

compare_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}"

contents_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/contents/{+path}"

contributors_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/contributors"

deployments_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/deployments"

downloads_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/downloads"

events_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/events"

forks_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/forks"

git_commits_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}"

git_refs_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}"

git_tags_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}"

git_url

string

issue_comment_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}"

issue_events_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/issues/events{/number}"

issues_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/issues{/number}"

keys_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/keys{/key_id}"

labels_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/labels{/name}"

languages_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/languages"

merges_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/merges"

milestones_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/milestones{/number}"

notifications_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}"

pulls_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/pulls{/number}"

releases_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/releases{/id}"

ssh_url

string

stargazers_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/stargazers"

statuses_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/statuses/{sha}"

subscribers_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/subscribers"

subscription_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/subscription"

tags_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/tags"

teams_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/teams"

trees_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}"

clone_url

string

mirror_url

string or null

hooks_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/hooks"

svn_url

string

homepage

string or null

language

string or null

forks_count

int

stargazers_count

int

watchers_count

int

size

int

The size of the repository. Size is calculated hourly. When a repository is initially created, the size is 0.

default_branch

string

open_issues_count

int

is_template

boolean

topics

array[string]

string

has_issues

boolean

has_projects

boolean

has_wiki

boolean

has_pages

boolean

has_downloads

boolean

has_discussions

boolean

archived

boolean

disabled

boolean

visibility

string

pushed_at

string or null

date-time

Example
"2011-01-26T19:06:43Z"

created_at

string or null

date-time

Example
"2011-01-26T19:01:12Z"

updated_at

string or null

date-time

Example
"2011-01-26T19:14:43Z"

permissions

object (permissions)

admin

boolean

maintain

boolean

push

boolean

triage

boolean

pull

boolean

role_name

string

Example
"admin"

temp_clone_token

string

delete_branch_on_merge

boolean

subscribers_count

int

network_count

int

code_of_conduct

object (code_of_conduct)

Code Of Conduct

key

string

required

Example
"contributor_covenant"

name

string

required

Example
"Contributor Covenant"

url

string

uri

required

Example
"https://api.github.com/codes_of_conduct/contributor_covenant"

body

string

Example
"# Contributor Covenant Code of Conduct\n\n## Our Pledge\n\nIn the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.\n\n## Our Standards\n\nExamples of behavior that contributes to creating a positive environment include:\n\n* Using welcoming and inclusive language\n* Being respectful of differing viewpoints and experiences\n* Gracefully accepting constructive criticism\n* Focusing on what is best for the community\n* Showing empathy towards other community members\n\nExamples of unacceptable behavior by participants include:\n\n* The use of sexualized language or imagery and unwelcome sexual attention or advances\n* Trolling, insulting/derogatory comments, and personal or political attacks\n* Public or private harassment\n* Publishing others' private information, such as a physical or electronic address, without explicit permission\n* Other conduct which could reasonably be considered inappropriate in a professional setting\n\n## Our Responsibilities\n\nProject maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response\n to any instances of unacceptable behavior.\n\nProject maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.\n\n## Scope\n\nThis Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address,\n posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.\n\n## Enforcement\n\nInstances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at [EMAIL]. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.\n\nProject maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.\n\n## Attribution\n\nThis Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]\n\n[homepage]: http://contributor-covenant.org\n[version]: http://contributor-covenant.org/version/1/4/\n"

html_url

string or null

uri

required

license

object (license) or null

key

string

name

string

spdx_id

string

url

string

node_id

string

forks

int

Example
0

open_issues

int

Example
0

watchers

int

Example
0

allow_forking

boolean

web_commit_signoff_required

boolean

Example
false

security_and_analysis

object (security_and_analysis) or null

advanced_security

object (advanced_security)

status

string

Enum
  • enabled
  • disabled

secret_scanning

object (secret_scanning)

status

string

Enum
  • enabled
  • disabled

secret_scanning_push_protection

object (secret_scanning_push_protection)

status

string

Enum
  • enabled
  • disabled

Create a required workflow

post /orgs/{org}/actions/required_workflows

Create a required workflow in an organization.

You must authenticate using an access token with the admin:org scope to use this endpoint.

For more information, see "Required Workflows."

org

string

required

The organization name. The name is not case sensitive.

workflow_file_path

string

required

Path of the workflow file to be configured as a required workflow.

repository_id

string

required

The ID of the repository that contains the workflow file.

scope

string

Enable the required workflow for all repositories or selected repositories in the organization.

Default
"all"
Enum
  • selected
  • all

selected_repository_ids

array[int]

A list of repository IDs where you want to enable the required workflow. You can only provide a list of repository ids when the scope is set to selected.

int

Unique identifier of the repository.

Request

{
  "workflow_file_path": ".github/workflows/ci.yaml",
  "repository_id": 53,
  "scope": "selected",
  "selected_repository_ids": [
    32,
    91
  ]
}

Response

Examples Schema

Response

{
  "id": 30433642,
  "name": "Required CI",
  "path": ".github/workflows/ci.yml",
  "scope": "selected",
  "ref": "refs/head/main",
  "state": "active",
  "selected_repositories_url": "https://api.github.com/orgs/octo-org/actions/required_workflows/1/repositories",
  "created_at": "2020-01-22T19:33:08Z",
  "updated_at": "2020-01-22T19:33:08Z",
  "repository": {
    "id": 1296269,
    "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5",
    "name": "Hello-World",
    "full_name": "octocat/Hello-World",
    "owner": {
      "login": "octocat",
      "id": 1,
      "node_id": "MDQ6VXNlcjE=",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "gravatar_id": "",
      "url": "https://api.github.com/users/octocat",
      "html_url": "https://github.com/octocat",
      "followers_url": "https://api.github.com/users/octocat/followers",
      "following_url": "https://api.github.com/users/octocat/following{/other_user}",
      "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
      "organizations_url": "https://api.github.com/users/octocat/orgs",
      "repos_url": "https://api.github.com/users/octocat/repos",
      "events_url": "https://api.github.com/users/octocat/events{/privacy}",
      "received_events_url": "https://api.github.com/users/octocat/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/octocat/Hello-World",
    "description": "This your first repo!",
    "fork": false,
    "url": "https://api.github.com/repos/octocat/Hello-World",
    "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
    "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}",
    "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
    "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}",
    "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
    "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}",
    "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}",
    "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
    "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}",
    "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors",
    "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments",
    "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads",
    "events_url": "https://api.github.com/repos/octocat/Hello-World/events",
    "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks",
    "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
    "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
    "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
    "git_url": "git:github.com/octocat/Hello-World.git",
    "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
    "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
    "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}",
    "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
    "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}",
    "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages",
    "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges",
    "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
    "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}",
    "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}",
    "ssh_url": "git@github.com:octocat/Hello-World.git",
    "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers",
    "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
    "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers",
    "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription",
    "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags",
    "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams",
    "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
    "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks"
  }
}

Validation failed, or the endpoint has been spammed.

{
  "message": "string",
  "documentation_url": "string",
  "errors": [
    "string"
  ]
}

id

number

required

Unique identifier for a required workflow

name

string

required

Name present in the workflow file

path

string

required

Path of the workflow file

scope

string

required

Scope of the required workflow

Enum
  • all
  • selected

ref

string

required

Ref at which the workflow file will be selected

state

string

required

State of the required workflow

Enum
  • active
  • deleted

selected_repositories_url

string

uri

Example
"https://api.github.com/organizations/org/actions/required_workflows/1/repositories"

created_at

string

date-time

required

updated_at

string

date-time

required

repository

object (repository)

required

Minimal Repository

id

int

required

Example
1296269

node_id

string

required

Example
"MDEwOlJlcG9zaXRvcnkxMjk2MjY5"

name

string

required

Example
"Hello-World"

full_name

string

required

Example
"octocat/Hello-World"

owner

object (owner)

required

A GitHub user.

name

string or null

email

string or null

login

string

required

Example
"octocat"

id

int

required

Example
1

node_id

string

required

Example
"MDQ6VXNlcjE="

avatar_url

string

uri

required

Example
"https://github.com/images/error/octocat_happy.gif"

gravatar_id

string or null

required

Example
"41d064eb2195891e12d0413f63227ea7"

url

string

uri

required

Example
"https://api.github.com/users/octocat"

html_url

string

uri

required

Example
"https://github.com/octocat"

followers_url

string

uri

required

Example
"https://api.github.com/users/octocat/followers"

following_url

string

required

Example
"https://api.github.com/users/octocat/following{/other_user}"

gists_url

string

required

Example
"https://api.github.com/users/octocat/gists{/gist_id}"

starred_url

string

required

Example
"https://api.github.com/users/octocat/starred{/owner}{/repo}"

subscriptions_url

string

uri

required

Example
"https://api.github.com/users/octocat/subscriptions"

organizations_url

string

uri

required

Example
"https://api.github.com/users/octocat/orgs"

repos_url

string

uri

required

Example
"https://api.github.com/users/octocat/repos"

events_url

string

required

Example
"https://api.github.com/users/octocat/events{/privacy}"

received_events_url

string

uri

required

Example
"https://api.github.com/users/octocat/received_events"

type

string

required

Example
"User"

site_admin

boolean

required

starred_at

string

Example
"\"2020-07-09T00:17:55Z\""

private

boolean

required

html_url

string

uri

required

Example
"https://github.com/octocat/Hello-World"

description

string or null

required

Example
"This your first repo!"

fork

boolean

required

url

string

uri

required

Example
"https://api.github.com/repos/octocat/Hello-World"

archive_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}"

assignees_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/assignees{/user}"

blobs_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}"

branches_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/branches{/branch}"

collaborators_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}"

comments_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/comments{/number}"

commits_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/commits{/sha}"

compare_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}"

contents_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/contents/{+path}"

contributors_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/contributors"

deployments_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/deployments"

downloads_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/downloads"

events_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/events"

forks_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/forks"

git_commits_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/commits{/sha}"

git_refs_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/refs{/sha}"

git_tags_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/tags{/sha}"

git_url

string

issue_comment_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/issues/comments{/number}"

issue_events_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/issues/events{/number}"

issues_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/issues{/number}"

keys_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/keys{/key_id}"

labels_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/labels{/name}"

languages_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/languages"

merges_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/merges"

milestones_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/milestones{/number}"

notifications_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}"

pulls_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/pulls{/number}"

releases_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/releases{/id}"

ssh_url

string

stargazers_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/stargazers"

statuses_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/statuses/{sha}"

subscribers_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/subscribers"

subscription_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/subscription"

tags_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/tags"

teams_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/teams"

trees_url

string

required

Example
"http://api.github.com/repos/octocat/Hello-World/git/trees{/sha}"

clone_url

string

mirror_url

string or null

hooks_url

string

uri

required

Example
"http://api.github.com/repos/octocat/Hello-World/hooks"

svn_url

string

homepage

string or null

language

string or null

forks_count

int

stargazers_count

int

watchers_count

int

size

int

The size of the repository. Size is calculated hourly. When a repository is initially created, the size is 0.

default_branch

string

open_issues_count

int

is_template

boolean

topics

array[string]

string

has_issues

boolean

has_projects

boolean

has_wiki

boolean

has_pages

boolean

has_downloads

boolean

has_discussions

boolean

archived

boolean

disabled

boolean

visibility

string

pushed_at

string or null

date-time

Example
"2011-01-26T19:06:43Z"

created_at

string or null

date-time

Example
"2011-01-26T19:01:12Z"

updated_at

string or null

date-time

Example
"2011-01-26T19:14:43Z"

permissions

object (permissions)

admin

boolean

maintain

boolean

push

boolean

triage

boolean

pull

boolean

role_name

string

Example
"admin"

temp_clone_token

string

delete_branch_on_merge

boolean

subscribers_count

int

network_count

int

code_of_conduct

object (code_of_conduct)

Code Of Conduct

key

string

required

Example
"contributor_covenant"

name

string

required

Example
"Contributor Covenant"

url

string

uri

required

Example
"https://api.github.com/codes_of_conduct/contributor_covenant"

body

string

Example
"# Contributor Covenant Code of Conduct\n\n## Our Pledge\n\nIn the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.\n\n## Our Standards\n\nExamples of behavior that contributes to creating a positive environment include:\n\n* Using welcoming and inclusive language\n* Being respectful of differing viewpoints and experiences\n* Gracefully accepting constructive criticism\n* Focusing on what is best for the community\n* Showing empathy towards other community members\n\nExamples of unacceptable behavior by participants include:\n\n* The use of sexualized language or imagery and unwelcome sexual attention or advances\n* Trolling, insulting/derogatory comments, and personal or political attacks\n* Public or private harassment\n* Publishing others' private information, such as a physical or electronic address, without explicit permission\n* Other conduct which could reasonably be considered inappropriate in a professional setting\n\n## Our Responsibilities\n\nProject maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response\n to any instances of unacceptable behavior.\n\nProject maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.\n\n## Scope\n\nThis Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address,\n posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.\n\n## Enforcement\n\nInstances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at [EMAIL]. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.\n\nProject maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.\n\n## Attribution\n\nThis Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]\n\n[homepage]: http://contributor-covenant.org\n[version]: http://contributor-covenant.org/version/1/4/\n"

html_url

string or null

uri

required

license

object (license) or null

key

string

name

string

spdx_id

string

url

string

node_id

string

forks

int

Example
0

open_issues

int

Example
0

watchers

int

Example
0

allow_forking

boolean

web_commit_signoff_required

boolean

Example
false

security_and_analysis

object (security_and_analysis) or null

advanced_security

object (advanced_security)

status

string

Enum
  • enabled
  • disabled

secret_scanning

object (secret_scanning)

status

string

Enum
  • enabled
  • disabled

secret_scanning_push_protection

object (secret_scanning_push_protection)

status

string

Enum
  • enabled
  • disabled

message

string

required

documentation_url

string

required

errors

array[string]

string

Get a required workflow

get /orgs/{org}/actions/required_workflows/{required_workflow_id}

Get a required workflow configured in an organization.

You must authenticate using an access token with the read:org scope to use this endpoint.

For more information, see "Required Workflows."

org

string

required

The organization name. The name is not case sensitive.

required_workflow_id

int

required

The unique identifier of the required workflow.

Response

Examples Schema

Response

{
  "id": 30433642,
  "name": "Required CI",
  "path": ".github/workflows/ci.yml",
  "scope": "selected",
  "ref": "refs/head/main",
  "state": "active",
  "selected_repositories_url": "https://api.github.com/orgs/octo-org/actions/required_workflows/1/repositories",
  "created_at": "2020-01-22T19:33:08Z",
  "updated_at": "2020-01-22T19:33:08Z",
  "repository": {
    "id": 1296269,
    "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5",
    "name": "Hello-World",
    "full_name": "octocat/Hello-World",
    "owner": {
      "login": "octocat",
      "id": 1,
      "node_id": "MDQ6VXNlcjE=",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "gravatar_id": "",
      "url": "https://api.github.com/users/octocat",
      "html_url": "https://github.com/octocat",
      "followers_url": "https://api.github.com/users/octocat/followers",
      "following_url": "https://api.github.com/users/octocat/following{/other_user}",
      "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
      "organizations_url": "https://api.github.com/users/octocat/orgs",
      "repos_url": "https://api.github.com/users/octocat/repos",
      "events_url": "https://api.github.com/users/octocat/events{/privacy}",
      "received_events_url": "https://api.github.com/users/octocat/received_events",
      "type": "User",
      "site_admin": false
    },
    "private": false,
    "html_url": "https://github.com/octocat/Hello-World",
    "description": "This your first repo!",
    "fork": false,
    "url": "https://api.github.com/repos/octocat/Hello-World",
    "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
    "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}",
    "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
    "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}",
    "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
    "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}",
    "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}",
    "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
    "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}",
    "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors",
    "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments",
    "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads",
    "events_url": "https://api.github.com/repos/octocat/Hello-World/events",
    "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks",
    "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
    "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
    "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
    "git_url": "git:github.com/octocat/Hello-World.git",
    "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
    "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
    "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}",
    "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
    "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}",
    "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages",
    "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges",
    "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}",
    "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
    "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}",
    "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}",
    "ssh_url": "git@github.com:octocat/Hello-World.git",
    "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers",
    "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
    "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers",
    "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription",
    "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags",
    "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams",
    "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
    "hooks_url": "http://api.github.com/repos/octocat/Hello-World/hooks"
  }
}

id

number

required

Unique identifier for a required workflow

name

string

required

Name present in the workflow file

path

string

required

Path of the workflow file

scope

string

required

Scope of the required workflow

Enum
  • all
  • selected

ref

string

required

Ref at which the workflow file will be selected

state

string

required

State of the required workflow

Enum
  • active
  • deleted

selected_repositories_url

string

uri

Example
"https://api.github.com/organizations/org/actions/required_workflows/1/repositories"

created_at

string

date-time

required

updated_at

string

date-time

required

repository

object (repository)

required

Minimal Repository