App Permissions

The permissions granted to the fine-grained access token.

Version ControlDevOpsCI/CDCode HostingEnterpriseSelf-HostedSAML SSOSCIMAdvanced SecurityDeveloper Tools

Properties

Name	Type	Description
actions	string	The level of permission to grant the access token for GitHub Actions workflows, workflow runs, and artifacts.
administration	string	The level of permission to grant the access token for repository creation, deletion, settings, teams, and collaborators creation.
artifact_metadata	string	The level of permission to grant the access token to create and retrieve build artifact metadata records.
attestations	string	The level of permission to create and retrieve the access token for repository attestations.
checks	string	The level of permission to grant the access token for checks on code.
code_quality	string	The level of permission to grant the access token to view and manage code quality data.
codespaces	string	The level of permission to grant the access token to create, edit, delete, and list Codespaces.
contents	string	The level of permission to grant the access token for repository contents, commits, branches, downloads, releases, and merges.
dependabot_secrets	string	The level of permission to grant the access token to manage Dependabot secrets.
deployments	string	The level of permission to grant the access token for deployments and deployment statuses.
discussions	string	The level of permission to grant the access token for discussions and related comments and labels.
environments	string	The level of permission to grant the access token for managing repository environments.
issues	string	The level of permission to grant the access token for issues and related comments, assignees, labels, and milestones.
merge_queues	string	The level of permission to grant the access token to manage the merge queues for a repository.
metadata	string	The level of permission to grant the access token to search repositories, list collaborators, and access repository metadata.
packages	string	The level of permission to grant the access token for packages published to GitHub Packages.
pages	string	The level of permission to grant the access token to retrieve Pages statuses, configuration, and builds, as well as create new builds.
pull_requests	string	The level of permission to grant the access token for pull requests and related comments, assignees, labels, milestones, and merges.
repository_custom_properties	string	The level of permission to grant the access token to view and edit custom properties for a repository, when allowed by the property.
repository_hooks	string	The level of permission to grant the access token to manage the post-receive hooks for a repository.
repository_projects	string	The level of permission to grant the access token to manage repository projects, columns, and cards.
secret_scanning_alerts	string	The level of permission to grant the access token to view and manage secret scanning alerts.
secrets	string	The level of permission to grant the access token to manage repository secrets.
security_events	string	The level of permission to grant the access token to view and manage security events like code scanning alerts.
single_file	string	The level of permission to grant the access token to manage just a single file.
statuses	string	The level of permission to grant the access token for commit statuses.
vulnerability_alerts	string	The level of permission to grant the access token to manage Dependabot alerts.
workflows	string	The level of permission to grant the access token to update GitHub Actions workflow files.
custom_properties_for_organizations	string	The level of permission to grant the access token to view and edit custom properties for an organization, when allowed by the property.
members	string	The level of permission to grant the access token for organization teams and members.
organization_administration	string	The level of permission to grant the access token to manage access to an organization.
organization_custom_roles	string	The level of permission to grant the access token for custom repository roles management.
organization_custom_org_roles	string	The level of permission to grant the access token for custom organization roles management.
organization_custom_properties	string	The level of permission to grant the access token for repository custom properties management at the organization level.
organization_copilot_seat_management	string	The level of permission to grant the access token for managing access to GitHub Copilot for members of an organization with a Copilot Business subscription. This property is in public preview and is s
organization_copilot_agent_settings	string	The level of permission to grant the access token to view and manage Copilot cloud agent settings for an organization.
organization_copilot_requests	string	The level of permission to grant the access token to make Copilot requests billed to the organization where the app is installed. This property is in public preview and is subject to change.
organization_external_properties_for_repos	string	The level of permission to grant the access token for managing external custom properties for repositories in an organization.
organization_announcement_banners	string	The level of permission to grant the access token to view and manage announcement banners for an organization.
organization_events	string	The level of permission to grant the access token to view events triggered by an activity in an organization.
organization_hooks	string	The level of permission to grant the access token to manage the post-receive hooks for an organization.
organization_personal_access_tokens	string	The level of permission to grant the access token for viewing and managing fine-grained personal access token requests to an organization.
organization_personal_access_token_requests	string	The level of permission to grant the access token for viewing and managing fine-grained personal access tokens that have been approved by an organization.
organization_plan	string	The level of permission to grant the access token for viewing an organization's plan.
organization_projects	string	The level of permission to grant the access token to manage organization projects and projects public preview (where available).
organization_packages	string	The level of permission to grant the access token for organization packages published to GitHub Packages.
organization_secrets	string	The level of permission to grant the access token to manage organization secrets.
organization_self_hosted_runners	string	The level of permission to grant the access token to view and manage GitHub Actions self-hosted runners available to an organization.
organization_user_blocking	string	The level of permission to grant the access token to view and manage users blocked by the organization.
email_addresses	string	The level of permission to grant the access token to manage the email addresses belonging to a user.
followers	string	The level of permission to grant the access token to manage the followers belonging to a user.
git_ssh_keys	string	The level of permission to grant the access token to manage git SSH keys.
gpg_keys	string	The level of permission to grant the access token to view and manage GPG keys belonging to a user.
interaction_limits	string	The level of permission to grant the access token to view and manage interaction limits on a repository.
profile	string	The level of permission to grant the access token to manage the profile settings belonging to a user.
starring	string	The level of permission to grant the access token to list and manage repositories a user is starring.
enterprise_administration	string	The level of permission to grant the access token to administer an enterprise account.
enterprise_custom_properties_for_organizations	string	The level of permission to grant the access token for organization custom properties management at the enterprise level.
enterprise_organization_installations	string	The level of permission to grant the access token to manage installation of GitHub Apps on Enterprise-owned organizations.
enterprise_organization_installation_repositories	string	The level of permission to grant the access token to manage repository access of GitHub Apps on Enterprise-owned organizations.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/github-enterprise/json-schema/github-enterprise-app-permissions-schema.json",
  "title": "App Permissions",
  "description": "The permissions granted to the fine-grained access token.",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/github-enterprise-openapi.yml#/components/schemas/app-permissions",
  "type": "object",
  "properties": {
    "actions": {
      "type": "string",
      "description": "The level of permission to grant the access token for GitHub Actions workflows, workflow runs, and artifacts.",
      "enum": [
        "read",
        "write"
      ]
    },
    "administration": {
      "type": "string",
      "description": "The level of permission to grant the access token for repository creation, deletion, settings, teams, and collaborators creation.",
      "enum": [
        "read",
        "write"
      ]
    },
    "artifact_metadata": {
      "type": "string",
      "description": "The level of permission to grant the access token to create and retrieve build artifact metadata records.",
      "enum": [
        "read",
        "write"
      ]
    },
    "attestations": {
      "type": "string",
      "description": "The level of permission to create and retrieve the access token for repository attestations.",
      "enum": [
        "read",
        "write"
      ]
    },
    "checks": {
      "type": "string",
      "description": "The level of permission to grant the access token for checks on code.",
      "enum": [
        "read",
        "write"
      ]
    },
    "code_quality": {
      "type": "string",
      "description": "The level of permission to grant the access token to view and manage code quality data.",
      "enum": [
        "read",
        "write"
      ]
    },
    "codespaces": {
      "type": "string",
      "description": "The level of permission to grant the access token to create, edit, delete, and list Codespaces.",
      "enum": [
        "read",
        "write"
      ]
    },
    "contents": {
      "type": "string",
      "description": "The level of permission to grant the access token for repository contents, commits, branches, downloads, releases, and merges.",
      "enum": [
        "read",
        "write"
      ]
    },
    "dependabot_secrets": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage Dependabot secrets.",
      "enum": [
        "read",
        "write"
      ]
    },
    "deployments": {
      "type": "string",
      "description": "The level of permission to grant the access token for deployments and deployment statuses.",
      "enum": [
        "read",
        "write"
      ]
    },
    "discussions": {
      "type": "string",
      "description": "The level of permission to grant the access token for discussions and related comments and labels.",
      "enum": [
        "read",
        "write"
      ]
    },
    "environments": {
      "type": "string",
      "description": "The level of permission to grant the access token for managing repository environments.",
      "enum": [
        "read",
        "write"
      ]
    },
    "issues": {
      "type": "string",
      "description": "The level of permission to grant the access token for issues and related comments, assignees, labels, and milestones.",
      "enum": [
        "read",
        "write"
      ]
    },
    "merge_queues": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage the merge queues for a repository.",
      "enum": [
        "read",
        "write"
      ]
    },
    "metadata": {
      "type": "string",
      "description": "The level of permission to grant the access token to search repositories, list collaborators, and access repository metadata.",
      "enum": [
        "read",
        "write"
      ]
    },
    "packages": {
      "type": "string",
      "description": "The level of permission to grant the access token for packages published to GitHub Packages.",
      "enum": [
        "read",
        "write"
      ]
    },
    "pages": {
      "type": "string",
      "description": "The level of permission to grant the access token to retrieve Pages statuses, configuration, and builds, as well as create new builds.",
      "enum": [
        "read",
        "write"
      ]
    },
    "pull_requests": {
      "type": "string",
      "description": "The level of permission to grant the access token for pull requests and related comments, assignees, labels, milestones, and merges.",
      "enum": [
        "read",
        "write"
      ]
    },
    "repository_custom_properties": {
      "type": "string",
      "description": "The level of permission to grant the access token to view and edit custom properties for a repository, when allowed by the property.",
      "enum": [
        "read",
        "write"
      ]
    },
    "repository_hooks": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage the post-receive hooks for a repository.",
      "enum": [
        "read",
        "write"
      ]
    },
    "repository_projects": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage repository projects, columns, and cards.",
      "enum": [
        "read",
        "write",
        "admin"
      ]
    },
    "secret_scanning_alerts": {
      "type": "string",
      "description": "The level of permission to grant the access token to view and manage secret scanning alerts.",
      "enum": [
        "read",
        "write"
      ]
    },
    "secrets": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage repository secrets.",
      "enum": [
        "read",
        "write"
      ]
    },
    "security_events": {
      "type": "string",
      "description": "The level of permission to grant the access token to view and manage security events like code scanning alerts.",
      "enum": [
        "read",
        "write"
      ]
    },
    "single_file": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage just a single file.",
      "enum": [
        "read",
        "write"
      ]
    },
    "statuses": {
      "type": "string",
      "description": "The level of permission to grant the access token for commit statuses.",
      "enum": [
        "read",
        "write"
      ]
    },
    "vulnerability_alerts": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage Dependabot alerts.",
      "enum": [
        "read",
        "write"
      ]
    },
    "workflows": {
      "type": "string",
      "description": "The level of permission to grant the access token to update GitHub Actions workflow files.",
      "enum": [
        "write"
      ]
    },
    "custom_properties_for_organizations": {
      "type": "string",
      "description": "The level of permission to grant the access token to view and edit custom properties for an organization, when allowed by the property.",
      "enum": [
        "read",
        "write"
      ]
    },
    "members": {
      "type": "string",
      "description": "The level of permission to grant the access token for organization teams and members.",
      "enum": [
        "read",
        "write"
      ]
    },
    "organization_administration": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage access to an organization.",
      "enum": [
        "read",
        "write"
      ]
    },
    "organization_custom_roles": {
      "type": "string",
      "description": "The level of permission to grant the access token for custom repository roles management.",
      "enum": [
        "read",
        "write"
      ]
    },
    "organization_custom_org_roles": {
      "type": "string",
      "description": "The level of permission to grant the access token for custom organization roles management.",
      "enum": [
        "read",
        "write"
      ]
    },
    "organization_custom_properties": {
      "type": "string",
      "description": "The level of permission to grant the access token for repository custom properties management at the organization level.",
      "enum": [
        "read",
        "write",
        "admin"
      ]
    },
    "organization_copilot_seat_management": {
      "type": "string",
      "description": "The level of permission to grant the access token for managing access to GitHub Copilot for members of an organization with a Copilot Business subscription. This property is in public preview and is subject to change.",
      "enum": [
        "read",
        "write"
      ]
    },
    "organization_copilot_agent_settings": {
      "type": "string",
      "description": "The level of permission to grant the access token to view and manage Copilot cloud agent settings for an organization.",
      "enum": [
        "read",
        "write"
      ]
    },
    "organization_copilot_requests": {
      "type": "string",
      "description": "The level of permission to grant the access token to make Copilot requests billed to the organization where the app is installed. This property is in public preview and is subject to change.",
      "enum": [
        "read"
      ]
    },
    "organization_external_properties_for_repos": {
      "type": "string",
      "description": "The level of permission to grant the access token for managing external custom properties for repositories in an organization.",
      "enum": [
        "read",
        "write",
        "admin"
      ]
    },
    "organization_announcement_banners": {
      "type": "string",
      "description": "The level of permission to grant the access token to view and manage announcement banners for an organization.",
      "enum": [
        "read",
        "write"
      ]
    },
    "organization_events": {
      "type": "string",
      "description": "The level of permission to grant the access token to view events triggered by an activity in an organization.",
      "enum": [
        "read"
      ]
    },
    "organization_hooks": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage the post-receive hooks for an organization.",
      "enum": [
        "read",
        "write"
      ]
    },
    "organization_personal_access_tokens": {
      "type": "string",
      "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access token requests to an organization.",
      "enum": [
        "read",
        "write"
      ]
    },
    "organization_personal_access_token_requests": {
      "type": "string",
      "description": "The level of permission to grant the access token for viewing and managing fine-grained personal access tokens that have been approved by an organization.",
      "enum": [
        "read",
        "write"
      ]
    },
    "organization_plan": {
      "type": "string",
      "description": "The level of permission to grant the access token for viewing an organization's plan.",
      "enum": [
        "read"
      ]
    },
    "organization_projects": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage organization projects and projects public preview (where available).",
      "enum": [
        "read",
        "write",
        "admin"
      ]
    },
    "organization_packages": {
      "type": "string",
      "description": "The level of permission to grant the access token for organization packages published to GitHub Packages.",
      "enum": [
        "read",
        "write"
      ]
    },
    "organization_secrets": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage organization secrets.",
      "enum": [
        "read",
        "write"
      ]
    },
    "organization_self_hosted_runners": {
      "type": "string",
      "description": "The level of permission to grant the access token to view and manage GitHub Actions self-hosted runners available to an organization.",
      "enum": [
        "read",
        "write"
      ]
    },
    "organization_user_blocking": {
      "type": "string",
      "description": "The level of permission to grant the access token to view and manage users blocked by the organization.",
      "enum": [
        "read",
        "write"
      ]
    },
    "email_addresses": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage the email addresses belonging to a user.",
      "enum": [
        "read",
        "write"
      ]
    },
    "followers": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage the followers belonging to a user.",
      "enum": [
        "read",
        "write"
      ]
    },
    "git_ssh_keys": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage git SSH keys.",
      "enum": [
        "read",
        "write"
      ]
    },
    "gpg_keys": {
      "type": "string",
      "description": "The level of permission to grant the access token to view and manage GPG keys belonging to a user.",
      "enum": [
        "read",
        "write"
      ]
    },
    "interaction_limits": {
      "type": "string",
      "description": "The level of permission to grant the access token to view and manage interaction limits on a repository.",
      "enum": [
        "read",
        "write"
      ]
    },
    "profile": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage the profile settings belonging to a user.",
      "enum": [
        "write"
      ]
    },
    "starring": {
      "type": "string",
      "description": "The level of permission to grant the access token to list and manage repositories a user is starring.",
      "enum": [
        "read",
        "write"
      ]
    },
    "enterprise_administration": {
      "type": "string",
      "description": "The level of permission to grant the access token to administer an enterprise account.",
      "enum": [
        "read",
        "write"
      ]
    },
    "enterprise_custom_properties_for_organizations": {
      "type": "string",
      "description": "The level of permission to grant the access token for organization custom properties management at the enterprise level.",
      "enum": [
        "read",
        "write",
        "admin"
      ]
    },
    "enterprise_organization_installations": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage installation of GitHub Apps on Enterprise-owned organizations.",
      "enum": [
        "read",
        "write"
      ]
    },
    "enterprise_organization_installation_repositories": {
      "type": "string",
      "description": "The level of permission to grant the access token to manage repository access of GitHub Apps on Enterprise-owned organizations.",
      "enum": [
        "read",
        "write"
      ]
    }
  }
}

Work with this as data

Every JSON Schema 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 schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
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 JSON Schema

curl "https://apis.io/api/v1/json-schemas/github-enterprise-app-permissions"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.