REST API endpoints for GitHub Actions policies - GitHub Enterprise Cloud Docs

List enterprise Actions policies

List all Actions policies for an enterprise.

Tokens de acceso granulares para "List enterprise Actions policies"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Enterprise administration" enterprise permissions (write)

Parámetros para "List enterprise Actions policies"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`enterprise` string Obligatorio The slug version of the enterprise name.

Parámetros de consulta
Nombre, Tipo, Descripción
`per_page` integer The number of results per page (max 100). For more information, see "Using pagination in the REST API." Valor predeterminado: `30`
`page` integer The page number of the results to fetch. For more information, see "Using pagination in the REST API." Valor predeterminado: `1`

Códigos de estado de respuesta HTTP para "List enterprise Actions policies"

código de estado	Descripción
`200`	OK
`404`	Resource not found
`500`	Internal Error

Ejemplos de código para "List enterprise Actions policies"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

get/enterprises/{enterprise}/actions/policies

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/actions/policies

Response

Status: 200

{
  "total_count": 2,
  "policies": [
    {
      "id": 1,
      "name": "Restrict workflow modifications",
      "target": "actions",
      "source_type": "Enterprise",
      "source": "enterprise",
      "enforcement": "active",
      "node_id": "RUL_lA",
      "_links": {
        "self": {
          "href": "https://api.github.com/enterprises/enterprise/actions/policies/1"
        },
        "html": {
          "href": "https://github.com/enterprises/enterprise/settings/policies/actions/1"
        }
      },
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": 2,
      "name": "Restrict workflow events",
      "target": "actions",
      "source_type": "Enterprise",
      "source": "enterprise",
      "enforcement": "evaluate",
      "node_id": "RUL_lB",
      "_links": {
        "self": {
          "href": "https://api.github.com/enterprises/enterprise/actions/policies/2"
        },
        "html": {
          "href": "https://github.com/enterprises/enterprise/settings/policies/actions/2"
        }
      },
      "created_at": "2024-01-15T11:00:00Z",
      "updated_at": "2024-01-15T11:00:00Z"
    }
  ]
}

Create an enterprise Actions policy

Create an Actions policy for an enterprise. Omitting workflow_path targets all workflows without storing an explicit condition.

Tokens de acceso granulares para "Create an enterprise Actions policy"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Enterprise administration" enterprise permissions (write)

Parámetros para "Create an enterprise Actions policy"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`enterprise` string Obligatorio The slug version of the enterprise name.

Nombre, Tipo, Descripción

name string Obligatorio

The name of the policy.

enforcement string Obligatorio

The enforcement level of the ruleset. evaluate allows admins to test rules before enforcing them. Admins can view insights on the Rule Insights page. evaluate is not available for the repository target.

Puede ser uno de los siguientes: disabled, active, evaluate

conditions object

Conditions for an enterprise Actions policy. The conditions object supports one organization target (organization_name, organization_id, or organization_property) combined with one repository target (repository_name or repository_property), and may also contain workflow_path.

Can be one of these objects:

Nombre, Tipo, Descripción

organization_name_and_repository_name object

Conditions to target organizations by name and repositories by name

Properties of organization_name_and_repository_name

Nombre, Tipo, Descripción

organization_name object Obligatorio

Properties of organization_name

Nombre, Tipo, Descripción
`include` array of strings Array of organization names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~ALL` to include all organizations and ~EMUS to target all enterprise managed user accounts.
`exclude` array of strings Array of organization names or patterns to exclude. The condition will not pass if any of these patterns match.

repository_name object Obligatorio

Properties of repository_name

Nombre, Tipo, Descripción
`include` array of strings Array of repository names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~ALL` to include all repositories.
`exclude` array of strings Array of repository names or patterns to exclude. The condition will not pass if any of these patterns match.
`protected` boolean Whether renaming of target repositories is prevented.

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

organization_name_and_repository_property object

Conditions to target organizations by name and repositories by property

Properties of organization_name_and_repository_property

Nombre, Tipo, Descripción

organization_name object Obligatorio

Properties of organization_name

Nombre, Tipo, Descripción
`include` array of strings Array of organization names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~ALL` to include all organizations and ~EMUS to target all enterprise managed user accounts.
`exclude` array of strings Array of organization names or patterns to exclude. The condition will not pass if any of these patterns match.

repository_property object Obligatorio

Properties of repository_property

Nombre, Tipo, Descripción

include array of objects

The repository properties and values to include. All of these properties must match for the condition to pass.

Properties of include

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

exclude array of objects

The repository properties and values to exclude. The condition will not pass if any of these properties match.

Properties of exclude

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

organization_id_and_repository_name object

Conditions to target organizations by id and repositories by name

Properties of organization_id_and_repository_name

Nombre, Tipo, Descripción

organization_id object Obligatorio

Properties of organization_id

Nombre, Tipo, Descripción
`organization_ids` array of integers The organization IDs that the ruleset applies to. One of these IDs must match for the condition to pass.

repository_name object Obligatorio

Properties of repository_name

Nombre, Tipo, Descripción
`include` array of strings Array of repository names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~ALL` to include all repositories.
`exclude` array of strings Array of repository names or patterns to exclude. The condition will not pass if any of these patterns match.
`protected` boolean Whether renaming of target repositories is prevented.

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

organization_id_and_repository_property object

Conditions to target organizations by id and repositories by property

Properties of organization_id_and_repository_property

Nombre, Tipo, Descripción

organization_id object Obligatorio

Properties of organization_id

Nombre, Tipo, Descripción
`organization_ids` array of integers The organization IDs that the ruleset applies to. One of these IDs must match for the condition to pass.

repository_property object Obligatorio

Properties of repository_property

Nombre, Tipo, Descripción

include array of objects

The repository properties and values to include. All of these properties must match for the condition to pass.

Properties of include

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

exclude array of objects

The repository properties and values to exclude. The condition will not pass if any of these properties match.

Properties of exclude

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

organization_property_and_repository_name object

Conditions to target organizations by property and repositories by name

Properties of organization_property_and_repository_name

Nombre, Tipo, Descripción

organization_property object Obligatorio

Properties of organization_property

Nombre, Tipo, Descripción

include array of objects

The organization properties and values to include. All of these properties must match for the condition to pass.

Properties of include

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the organization property to target
`property_values` array of strings Obligatorio The values to match for the organization property

exclude array of objects

The organization properties and values to exclude. The condition will not pass if any of these properties match.

Properties of exclude

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the organization property to target
`property_values` array of strings Obligatorio The values to match for the organization property

repository_name object Obligatorio

Properties of repository_name

Nombre, Tipo, Descripción
`include` array of strings Array of repository names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~ALL` to include all repositories.
`exclude` array of strings Array of repository names or patterns to exclude. The condition will not pass if any of these patterns match.
`protected` boolean Whether renaming of target repositories is prevented.

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

organization_property_and_repository_property object

Conditions to target organizations by property and repositories by property

Properties of organization_property_and_repository_property

Nombre, Tipo, Descripción

organization_property object Obligatorio

Properties of organization_property

Nombre, Tipo, Descripción

include array of objects

The organization properties and values to include. All of these properties must match for the condition to pass.

Properties of include

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the organization property to target
`property_values` array of strings Obligatorio The values to match for the organization property

exclude array of objects

The organization properties and values to exclude. The condition will not pass if any of these properties match.

Properties of exclude

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the organization property to target
`property_values` array of strings Obligatorio The values to match for the organization property

repository_property object Obligatorio

Properties of repository_property

Nombre, Tipo, Descripción

include array of objects

The repository properties and values to include. All of these properties must match for the condition to pass.

Properties of include

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

exclude array of objects

The repository properties and values to exclude. The condition will not pass if any of these properties match.

Properties of exclude

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

rules array of objects

An array of rules within the policy.

Can be one of these objects:

Nombre, Tipo, Descripción

restrict_actions_actors object

Choose specific actors that are authorized to trigger Actions workflows.

Properties of restrict_actions_actors

Nombre, Tipo, Descripción

type string Obligatorio

Valor: restrict_actions_actors

parameters object

Properties of parameters

Nombre, Tipo, Descripción

allowed_actors array of objects Obligatorio

Select the actors who can run Actions workflows.

Properties of allowed_actors

Nombre, Tipo, Descripción
`id` integer Obligatorio ID of the actor authorized to trigger Actions workflows.
`type` string Obligatorio The type of the actor Puede ser uno de los siguientes: `User`, `Bot`, `Team`, `BusinessTeam`, `EnterpriseTeam`, `IntegrationInstallation`, `App`, `RepositoryRole`

restrict_action_events object

Choose specific GitHub events that will trigger Actions workflows.

Properties of restrict_action_events

Nombre, Tipo, Descripción

type string Obligatorio

Valor: restrict_action_events

parameters object

Properties of parameters

Nombre, Tipo, Descripción

allowed_events array of strings Obligatorio

Select the events that can trigger Actions workflows. Supported values are: branch_protection_rule, check_run, check_suite, create, delete, deployment, deployment_status, discussion, discussion_comment, fork, gollum, image_version, issue_comment, issues, label, merge_group, milestone, page_build, project, project_card, project_column, public, pull_request, pull_request_review, pull_request_review_comment, pull_request_target, push, registry_package, release, repository_dispatch, schedule, status, watch, workflow_call, workflow_dispatch, workflow_run

Códigos de estado de respuesta HTTP para "Create an enterprise Actions policy"

código de estado	Descripción
`201`	Created
`404`	Resource not found
`422`	Validation failed, or the endpoint has been spammed.
`500`	Internal Error

Ejemplos de código para "Create an enterprise Actions policy"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

post/enterprises/{enterprise}/actions/policies

curl -L \
  -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/actions/policies \
  -d '{"name":"Require approved actors","enforcement":"active","rules":[{"type":"restrict_actions_actors","parameters":{"allowed_actors":[{"id":1234,"type":"Team"}]}}]}'

Response

Status: 201

{
  "id": 1,
  "name": "Restrict workflow modifications",
  "target": "actions",
  "source_type": "Enterprise",
  "source": "enterprise",
  "enforcement": "active",
  "conditions": {
    "organization_name": {
      "include": [
        "octo-org"
      ],
      "exclude": []
    },
    "repository_name": {
      "include": [
        "octo-repo"
      ],
      "exclude": []
    }
  },
  "rules": [
    {
      "type": "restrict_actions_actors",
      "parameters": {
        "allowed_actors": [
          {
            "id": 5,
            "type": "User"
          },
          {
            "id": 1234,
            "type": "Team"
          }
        ]
      }
    }
  ],
  "node_id": "RUL_lA",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Get an enterprise Actions policy

Get a specific Actions policy for an enterprise.

Tokens de acceso granulares para "Get an enterprise Actions policy"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Enterprise administration" enterprise permissions (write)

Parámetros para "Get an enterprise Actions policy"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`enterprise` string Obligatorio The slug version of the enterprise name.
`policy_id` integer Obligatorio The ID of the policy.

Códigos de estado de respuesta HTTP para "Get an enterprise Actions policy"

código de estado	Descripción
`200`	OK
`404`	Resource not found
`500`	Internal Error

Ejemplos de código para "Get an enterprise Actions policy"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

get/enterprises/{enterprise}/actions/policies/{policy_id}

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/actions/policies/POLICY_ID

Response

Status: 200

{
  "id": 1,
  "name": "Restrict workflow modifications",
  "target": "actions",
  "source_type": "Enterprise",
  "source": "enterprise",
  "enforcement": "active",
  "conditions": {
    "organization_name": {
      "include": [
        "octo-org"
      ],
      "exclude": []
    },
    "repository_name": {
      "include": [
        "octo-repo"
      ],
      "exclude": []
    }
  },
  "rules": [
    {
      "type": "restrict_actions_actors",
      "parameters": {
        "allowed_actors": [
          {
            "id": 5,
            "type": "User"
          },
          {
            "id": 1234,
            "type": "Team"
          }
        ]
      }
    }
  ],
  "node_id": "RUL_lA",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Update an enterprise Actions policy

Update an Actions policy for an enterprise. Omitting workflow_path preserves the policy's existing workflow targeting.

Tokens de acceso granulares para "Update an enterprise Actions policy"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Enterprise administration" enterprise permissions (write)

Parámetros para "Update an enterprise Actions policy"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`enterprise` string Obligatorio The slug version of the enterprise name.
`policy_id` integer Obligatorio The ID of the policy.

Nombre, Tipo, Descripción

name string

The name of the policy.

enforcement string

Puede ser uno de los siguientes: disabled, active, evaluate

conditions object

Can be one of these objects:

Nombre, Tipo, Descripción

organization_name_and_repository_name object

Conditions to target organizations by name and repositories by name

Properties of organization_name_and_repository_name

Nombre, Tipo, Descripción

organization_name object Obligatorio

Properties of organization_name

Nombre, Tipo, Descripción
`include` array of strings Array of organization names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~ALL` to include all organizations and ~EMUS to target all enterprise managed user accounts.
`exclude` array of strings Array of organization names or patterns to exclude. The condition will not pass if any of these patterns match.

repository_name object Obligatorio

Properties of repository_name

Nombre, Tipo, Descripción
`include` array of strings Array of repository names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~ALL` to include all repositories.
`exclude` array of strings Array of repository names or patterns to exclude. The condition will not pass if any of these patterns match.
`protected` boolean Whether renaming of target repositories is prevented.

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

organization_name_and_repository_property object

Conditions to target organizations by name and repositories by property

Properties of organization_name_and_repository_property

Nombre, Tipo, Descripción

organization_name object Obligatorio

Properties of organization_name

Nombre, Tipo, Descripción
`include` array of strings Array of organization names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~ALL` to include all organizations and ~EMUS to target all enterprise managed user accounts.
`exclude` array of strings Array of organization names or patterns to exclude. The condition will not pass if any of these patterns match.

repository_property object Obligatorio

Properties of repository_property

Nombre, Tipo, Descripción

include array of objects

The repository properties and values to include. All of these properties must match for the condition to pass.

Properties of include

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

exclude array of objects

The repository properties and values to exclude. The condition will not pass if any of these properties match.

Properties of exclude

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

organization_id_and_repository_name object

Conditions to target organizations by id and repositories by name

Properties of organization_id_and_repository_name

Nombre, Tipo, Descripción

organization_id object Obligatorio

Properties of organization_id

Nombre, Tipo, Descripción
`organization_ids` array of integers The organization IDs that the ruleset applies to. One of these IDs must match for the condition to pass.

repository_name object Obligatorio

Properties of repository_name

Nombre, Tipo, Descripción
`include` array of strings Array of repository names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~ALL` to include all repositories.
`exclude` array of strings Array of repository names or patterns to exclude. The condition will not pass if any of these patterns match.
`protected` boolean Whether renaming of target repositories is prevented.

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

organization_id_and_repository_property object

Conditions to target organizations by id and repositories by property

Properties of organization_id_and_repository_property

Nombre, Tipo, Descripción

organization_id object Obligatorio

Properties of organization_id

Nombre, Tipo, Descripción
`organization_ids` array of integers The organization IDs that the ruleset applies to. One of these IDs must match for the condition to pass.

repository_property object Obligatorio

Properties of repository_property

Nombre, Tipo, Descripción

include array of objects

The repository properties and values to include. All of these properties must match for the condition to pass.

Properties of include

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

exclude array of objects

The repository properties and values to exclude. The condition will not pass if any of these properties match.

Properties of exclude

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

organization_property_and_repository_name object

Conditions to target organizations by property and repositories by name

Properties of organization_property_and_repository_name

Nombre, Tipo, Descripción

organization_property object Obligatorio

Properties of organization_property

Nombre, Tipo, Descripción

include array of objects

The organization properties and values to include. All of these properties must match for the condition to pass.

Properties of include

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the organization property to target
`property_values` array of strings Obligatorio The values to match for the organization property

exclude array of objects

The organization properties and values to exclude. The condition will not pass if any of these properties match.

Properties of exclude

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the organization property to target
`property_values` array of strings Obligatorio The values to match for the organization property

repository_name object Obligatorio

Properties of repository_name

Nombre, Tipo, Descripción
`include` array of strings Array of repository names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~ALL` to include all repositories.
`exclude` array of strings Array of repository names or patterns to exclude. The condition will not pass if any of these patterns match.
`protected` boolean Whether renaming of target repositories is prevented.

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

organization_property_and_repository_property object

Conditions to target organizations by property and repositories by property

Properties of organization_property_and_repository_property

Nombre, Tipo, Descripción

organization_property object Obligatorio

Properties of organization_property

Nombre, Tipo, Descripción

include array of objects

The organization properties and values to include. All of these properties must match for the condition to pass.

Properties of include

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the organization property to target
`property_values` array of strings Obligatorio The values to match for the organization property

exclude array of objects

The organization properties and values to exclude. The condition will not pass if any of these properties match.

Properties of exclude

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the organization property to target
`property_values` array of strings Obligatorio The values to match for the organization property

repository_property object Obligatorio

Properties of repository_property

Nombre, Tipo, Descripción

include array of objects

The repository properties and values to include. All of these properties must match for the condition to pass.

Properties of include

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

exclude array of objects

The repository properties and values to exclude. The condition will not pass if any of these properties match.

Properties of exclude

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

rules array of objects

An array of rules within the policy.

Can be one of these objects:

Nombre, Tipo, Descripción

restrict_actions_actors object

Choose specific actors that are authorized to trigger Actions workflows.

Properties of restrict_actions_actors

Nombre, Tipo, Descripción

type string Obligatorio

Valor: restrict_actions_actors

parameters object

Properties of parameters

Nombre, Tipo, Descripción

allowed_actors array of objects Obligatorio

Select the actors who can run Actions workflows.

Properties of allowed_actors

Nombre, Tipo, Descripción
`id` integer Obligatorio ID of the actor authorized to trigger Actions workflows.
`type` string Obligatorio The type of the actor Puede ser uno de los siguientes: `User`, `Bot`, `Team`, `BusinessTeam`, `EnterpriseTeam`, `IntegrationInstallation`, `App`, `RepositoryRole`

restrict_action_events object

Choose specific GitHub events that will trigger Actions workflows.

Properties of restrict_action_events

Nombre, Tipo, Descripción

type string Obligatorio

Valor: restrict_action_events

parameters object

Properties of parameters

Nombre, Tipo, Descripción

allowed_events array of strings Obligatorio

Códigos de estado de respuesta HTTP para "Update an enterprise Actions policy"

código de estado	Descripción
`200`	OK
`404`	Resource not found
`422`	Validation failed, or the endpoint has been spammed.
`500`	Internal Error

Ejemplos de código para "Update an enterprise Actions policy"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

put/enterprises/{enterprise}/actions/policies/{policy_id}

curl -L \
  -X PUT \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/actions/policies/POLICY_ID \
  -d '{"name":"Updated policy name","enforcement":"active"}'

Response

Status: 200

{
  "id": 1,
  "name": "Restrict workflow modifications",
  "target": "actions",
  "source_type": "Enterprise",
  "source": "enterprise",
  "enforcement": "active",
  "conditions": {
    "organization_name": {
      "include": [
        "octo-org"
      ],
      "exclude": []
    },
    "repository_name": {
      "include": [
        "octo-repo"
      ],
      "exclude": []
    }
  },
  "rules": [
    {
      "type": "restrict_actions_actors",
      "parameters": {
        "allowed_actors": [
          {
            "id": 5,
            "type": "User"
          },
          {
            "id": 1234,
            "type": "Team"
          }
        ]
      }
    }
  ],
  "node_id": "RUL_lA",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Delete an enterprise Actions policy

Delete an Actions policy for an enterprise.

Tokens de acceso granulares para "Delete an enterprise Actions policy"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Enterprise administration" enterprise permissions (write)

Parámetros para "Delete an enterprise Actions policy"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`enterprise` string Obligatorio The slug version of the enterprise name.
`policy_id` integer Obligatorio The ID of the policy.

Códigos de estado de respuesta HTTP para "Delete an enterprise Actions policy"

código de estado	Descripción
`204`	No Content
`404`	Resource not found
`500`	Internal Error

Ejemplos de código para "Delete an enterprise Actions policy"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

delete/enterprises/{enterprise}/actions/policies/{policy_id}

curl -L \
  -X DELETE \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/actions/policies/POLICY_ID

Response

Status: 204

List organization Actions policies

List all Actions policies for an organization.

Tokens de acceso granulares para "List organization Actions policies"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Administration" organization permissions (write)

Parámetros para "List organization Actions policies"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`org` string Obligatorio The organization name. The name is not case sensitive.

Parámetros de consulta
Nombre, Tipo, Descripción
`per_page` integer The number of results per page (max 100). For more information, see "Using pagination in the REST API." Valor predeterminado: `30`
`page` integer The page number of the results to fetch. For more information, see "Using pagination in the REST API." Valor predeterminado: `1`
`has_parents` boolean Include policies configured at higher levels that apply to this organization Valor predeterminado: `true`

Códigos de estado de respuesta HTTP para "List organization Actions policies"

código de estado	Descripción
`200`	OK
`404`	Resource not found
`500`	Internal Error

Ejemplos de código para "List organization Actions policies"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

get/orgs/{org}/actions/policies

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/orgs/ORG/actions/policies

Response

Status: 200

{
  "total_count": 2,
  "policies": [
    {
      "id": 1,
      "name": "Restrict workflow modifications",
      "target": "actions",
      "source_type": "Enterprise",
      "source": "enterprise",
      "enforcement": "active",
      "node_id": "RUL_lA",
      "_links": {
        "self": {
          "href": "https://api.github.com/enterprises/enterprise/actions/policies/1"
        },
        "html": {
          "href": "https://github.com/enterprises/enterprise/settings/policies/actions/1"
        }
      },
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": 2,
      "name": "Restrict workflow events",
      "target": "actions",
      "source_type": "Enterprise",
      "source": "enterprise",
      "enforcement": "evaluate",
      "node_id": "RUL_lB",
      "_links": {
        "self": {
          "href": "https://api.github.com/enterprises/enterprise/actions/policies/2"
        },
        "html": {
          "href": "https://github.com/enterprises/enterprise/settings/policies/actions/2"
        }
      },
      "created_at": "2024-01-15T11:00:00Z",
      "updated_at": "2024-01-15T11:00:00Z"
    }
  ]
}

Create an organization Actions policy

Create an Actions policy for an organization. Omitting workflow_path targets all workflows without storing an explicit condition.

Tokens de acceso granulares para "Create an organization Actions policy"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Administration" organization permissions (write)

Parámetros para "Create an organization Actions policy"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`org` string Obligatorio The organization name. The name is not case sensitive.

Nombre, Tipo, Descripción

name string Obligatorio

The name of the policy.

enforcement string Obligatorio

Puede ser uno de los siguientes: disabled, active, evaluate

conditions object

Conditions for an organization Actions policy. The conditions object should contain one of repository_name, repository_id, or repository_property, and may also contain workflow_path.

Can be one of these objects:

Nombre, Tipo, Descripción

Repository ruleset conditions for repository names object

Parameters for a repository name condition

Properties of Repository ruleset conditions for repository names

Nombre, Tipo, Descripción

repository_name object Obligatorio

Properties of repository_name

Nombre, Tipo, Descripción
`include` array of strings Array of repository names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~ALL` to include all repositories.
`exclude` array of strings Array of repository names or patterns to exclude. The condition will not pass if any of these patterns match.
`protected` boolean Whether renaming of target repositories is prevented.

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

Repository ruleset conditions for repository IDs object

Parameters for a repository ID condition

Properties of Repository ruleset conditions for repository IDs

Nombre, Tipo, Descripción

repository_id object Obligatorio

Properties of repository_id

Nombre, Tipo, Descripción
`repository_ids` array of integers The repository IDs that the ruleset applies to. One of these IDs must match for the condition to pass.

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

Repository ruleset conditions for repository properties object

Parameters for a repository property condition

Properties of Repository ruleset conditions for repository properties

Nombre, Tipo, Descripción

repository_property object Obligatorio

Properties of repository_property

Nombre, Tipo, Descripción

include array of objects

The repository properties and values to include. All of these properties must match for the condition to pass.

Properties of include

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

exclude array of objects

The repository properties and values to exclude. The condition will not pass if any of these properties match.

Properties of exclude

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

rules array of objects

An array of rules within the policy.

Can be one of these objects:

Nombre, Tipo, Descripción

restrict_actions_actors object

Choose specific actors that are authorized to trigger Actions workflows.

Properties of restrict_actions_actors

Nombre, Tipo, Descripción

type string Obligatorio

Valor: restrict_actions_actors

parameters object

Properties of parameters

Nombre, Tipo, Descripción

allowed_actors array of objects Obligatorio

Select the actors who can run Actions workflows.

Properties of allowed_actors

Nombre, Tipo, Descripción
`id` integer Obligatorio ID of the actor authorized to trigger Actions workflows.
`type` string Obligatorio The type of the actor Puede ser uno de los siguientes: `User`, `Bot`, `Team`, `BusinessTeam`, `EnterpriseTeam`, `IntegrationInstallation`, `App`, `RepositoryRole`

restrict_action_events object

Choose specific GitHub events that will trigger Actions workflows.

Properties of restrict_action_events

Nombre, Tipo, Descripción

type string Obligatorio

Valor: restrict_action_events

parameters object

Properties of parameters

Nombre, Tipo, Descripción

allowed_events array of strings Obligatorio

Códigos de estado de respuesta HTTP para "Create an organization Actions policy"

código de estado	Descripción
`201`	Created
`404`	Resource not found
`422`	Validation failed, or the endpoint has been spammed.
`500`	Internal Error

Ejemplos de código para "Create an organization Actions policy"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

post/orgs/{org}/actions/policies

curl -L \
  -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/orgs/ORG/actions/policies \
  -d '{"name":"Require approved actors","enforcement":"active","rules":[{"type":"restrict_actions_actors","parameters":{"allowed_actors":[{"id":1234,"type":"Team"}]}}]}'

Response

Status: 201

{
  "id": 1,
  "name": "Restrict workflow modifications",
  "target": "actions",
  "source_type": "Enterprise",
  "source": "enterprise",
  "enforcement": "active",
  "conditions": {
    "organization_name": {
      "include": [
        "octo-org"
      ],
      "exclude": []
    },
    "repository_name": {
      "include": [
        "octo-repo"
      ],
      "exclude": []
    }
  },
  "rules": [
    {
      "type": "restrict_actions_actors",
      "parameters": {
        "allowed_actors": [
          {
            "id": 5,
            "type": "User"
          },
          {
            "id": 1234,
            "type": "Team"
          }
        ]
      }
    }
  ],
  "node_id": "RUL_lA",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Get an organization Actions policy

Get a specific Actions policy for an organization.

Tokens de acceso granulares para "Get an organization Actions policy"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Administration" organization permissions (write)

Parámetros para "Get an organization Actions policy"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`org` string Obligatorio The organization name. The name is not case sensitive.
`policy_id` integer Obligatorio The ID of the policy.

Códigos de estado de respuesta HTTP para "Get an organization Actions policy"

código de estado	Descripción
`200`	OK
`404`	Resource not found
`500`	Internal Error

Ejemplos de código para "Get an organization Actions policy"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

get/orgs/{org}/actions/policies/{policy_id}

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/orgs/ORG/actions/policies/POLICY_ID

Response

Status: 200

{
  "id": 1,
  "name": "Restrict workflow modifications",
  "target": "actions",
  "source_type": "Enterprise",
  "source": "enterprise",
  "enforcement": "active",
  "conditions": {
    "organization_name": {
      "include": [
        "octo-org"
      ],
      "exclude": []
    },
    "repository_name": {
      "include": [
        "octo-repo"
      ],
      "exclude": []
    }
  },
  "rules": [
    {
      "type": "restrict_actions_actors",
      "parameters": {
        "allowed_actors": [
          {
            "id": 5,
            "type": "User"
          },
          {
            "id": 1234,
            "type": "Team"
          }
        ]
      }
    }
  ],
  "node_id": "RUL_lA",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Update an organization Actions policy

Update an Actions policy for an organization. Omitting workflow_path preserves the policy's existing workflow targeting.

Tokens de acceso granulares para "Update an organization Actions policy"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Administration" organization permissions (write)

Parámetros para "Update an organization Actions policy"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`org` string Obligatorio The organization name. The name is not case sensitive.
`policy_id` integer Obligatorio The ID of the policy.

Nombre, Tipo, Descripción

name string

The name of the policy.

enforcement string

Puede ser uno de los siguientes: disabled, active, evaluate

conditions object

Conditions for an organization Actions policy. The conditions object should contain one of repository_name, repository_id, or repository_property, and may also contain workflow_path.

Can be one of these objects:

Nombre, Tipo, Descripción

Repository ruleset conditions for repository names object

Parameters for a repository name condition

Properties of Repository ruleset conditions for repository names

Nombre, Tipo, Descripción

repository_name object Obligatorio

Properties of repository_name

Nombre, Tipo, Descripción
`include` array of strings Array of repository names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~ALL` to include all repositories.
`exclude` array of strings Array of repository names or patterns to exclude. The condition will not pass if any of these patterns match.
`protected` boolean Whether renaming of target repositories is prevented.

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

Repository ruleset conditions for repository IDs object

Parameters for a repository ID condition

Properties of Repository ruleset conditions for repository IDs

Nombre, Tipo, Descripción

repository_id object Obligatorio

Properties of repository_id

Nombre, Tipo, Descripción
`repository_ids` array of integers The repository IDs that the ruleset applies to. One of these IDs must match for the condition to pass.

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

Repository ruleset conditions for repository properties object

Parameters for a repository property condition

Properties of Repository ruleset conditions for repository properties

Nombre, Tipo, Descripción

repository_property object Obligatorio

Properties of repository_property

Nombre, Tipo, Descripción

include array of objects

The repository properties and values to include. All of these properties must match for the condition to pass.

Properties of include

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

exclude array of objects

The repository properties and values to exclude. The condition will not pass if any of these properties match.

Properties of exclude

Nombre, Tipo, Descripción
`name` string Obligatorio The name of the repository property to target
`property_values` array of strings Obligatorio The values to match for the repository property
`source` string The source of the repository property. Defaults to 'custom' if not specified. Puede ser uno de los siguientes: `custom`, `system`

workflow_path object

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

rules array of objects

An array of rules within the policy.

Can be one of these objects:

Nombre, Tipo, Descripción

restrict_actions_actors object

Choose specific actors that are authorized to trigger Actions workflows.

Properties of restrict_actions_actors

Nombre, Tipo, Descripción

type string Obligatorio

Valor: restrict_actions_actors

parameters object

Properties of parameters

Nombre, Tipo, Descripción

allowed_actors array of objects Obligatorio

Select the actors who can run Actions workflows.

Properties of allowed_actors

Nombre, Tipo, Descripción
`id` integer Obligatorio ID of the actor authorized to trigger Actions workflows.
`type` string Obligatorio The type of the actor Puede ser uno de los siguientes: `User`, `Bot`, `Team`, `BusinessTeam`, `EnterpriseTeam`, `IntegrationInstallation`, `App`, `RepositoryRole`

restrict_action_events object

Choose specific GitHub events that will trigger Actions workflows.

Properties of restrict_action_events

Nombre, Tipo, Descripción

type string Obligatorio

Valor: restrict_action_events

parameters object

Properties of parameters

Nombre, Tipo, Descripción

allowed_events array of strings Obligatorio

Códigos de estado de respuesta HTTP para "Update an organization Actions policy"

código de estado	Descripción
`200`	OK
`404`	Resource not found
`422`	Validation failed, or the endpoint has been spammed.
`500`	Internal Error

Ejemplos de código para "Update an organization Actions policy"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

put/orgs/{org}/actions/policies/{policy_id}

curl -L \
  -X PUT \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/orgs/ORG/actions/policies/POLICY_ID \
  -d '{"name":"Updated policy name","enforcement":"active"}'

Response

Status: 200

{
  "id": 1,
  "name": "Restrict workflow modifications",
  "target": "actions",
  "source_type": "Enterprise",
  "source": "enterprise",
  "enforcement": "active",
  "conditions": {
    "organization_name": {
      "include": [
        "octo-org"
      ],
      "exclude": []
    },
    "repository_name": {
      "include": [
        "octo-repo"
      ],
      "exclude": []
    }
  },
  "rules": [
    {
      "type": "restrict_actions_actors",
      "parameters": {
        "allowed_actors": [
          {
            "id": 5,
            "type": "User"
          },
          {
            "id": 1234,
            "type": "Team"
          }
        ]
      }
    }
  ],
  "node_id": "RUL_lA",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Delete an organization Actions policy

Delete an Actions policy for an organization.

Tokens de acceso granulares para "Delete an organization Actions policy"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Administration" organization permissions (write)

Parámetros para "Delete an organization Actions policy"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`org` string Obligatorio The organization name. The name is not case sensitive.
`policy_id` integer Obligatorio The ID of the policy.

Códigos de estado de respuesta HTTP para "Delete an organization Actions policy"

código de estado	Descripción
`204`	No Content
`404`	Resource not found
`500`	Internal Error

Ejemplos de código para "Delete an organization Actions policy"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

delete/orgs/{org}/actions/policies/{policy_id}

curl -L \
  -X DELETE \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/orgs/ORG/actions/policies/POLICY_ID

Response

Status: 204

List repository Actions policies

List all Actions policies for a repository.

Tokens de acceso granulares para "List repository Actions policies"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Administration" repository permissions (write)

Parámetros para "List repository Actions policies"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`owner` string Obligatorio The account owner of the repository. The name is not case sensitive.
`repo` string Obligatorio The name of the repository without the `.git` extension. The name is not case sensitive.

Parámetros de consulta
Nombre, Tipo, Descripción
`per_page` integer The number of results per page (max 100). For more information, see "Using pagination in the REST API." Valor predeterminado: `30`
`page` integer The page number of the results to fetch. For more information, see "Using pagination in the REST API." Valor predeterminado: `1`
`has_parents` boolean Include policies configured at higher levels that apply to this repository Valor predeterminado: `true`

Códigos de estado de respuesta HTTP para "List repository Actions policies"

código de estado	Descripción
`200`	OK
`404`	Resource not found
`500`	Internal Error

Ejemplos de código para "List repository Actions policies"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

get/repos/{owner}/{repo}/actions/policies

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/repos/OWNER/REPO/actions/policies

Response

Status: 200

{
  "total_count": 2,
  "policies": [
    {
      "id": 1,
      "name": "Restrict workflow modifications",
      "target": "actions",
      "source_type": "Enterprise",
      "source": "enterprise",
      "enforcement": "active",
      "node_id": "RUL_lA",
      "_links": {
        "self": {
          "href": "https://api.github.com/enterprises/enterprise/actions/policies/1"
        },
        "html": {
          "href": "https://github.com/enterprises/enterprise/settings/policies/actions/1"
        }
      },
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": 2,
      "name": "Restrict workflow events",
      "target": "actions",
      "source_type": "Enterprise",
      "source": "enterprise",
      "enforcement": "evaluate",
      "node_id": "RUL_lB",
      "_links": {
        "self": {
          "href": "https://api.github.com/enterprises/enterprise/actions/policies/2"
        },
        "html": {
          "href": "https://github.com/enterprises/enterprise/settings/policies/actions/2"
        }
      },
      "created_at": "2024-01-15T11:00:00Z",
      "updated_at": "2024-01-15T11:00:00Z"
    }
  ]
}

Create a repository Actions policy

Create an Actions policy for a repository. Omitting workflow_path targets all workflows without storing an explicit condition.

Tokens de acceso granulares para "Create a repository Actions policy"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Administration" repository permissions (write)

Parámetros para "Create a repository Actions policy"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`owner` string Obligatorio The account owner of the repository. The name is not case sensitive.
`repo` string Obligatorio The name of the repository without the `.git` extension. The name is not case sensitive.

Nombre, Tipo, Descripción

name string Obligatorio

The name of the policy.

enforcement string Obligatorio

Puede ser uno de los siguientes: disabled, active, evaluate

conditions object

Conditions for a repository Actions policy. The object may be empty to preserve or use the default workflow targeting, or contain only workflow_path.

Can be one of these objects:

Nombre, Tipo, Descripción

object

Properties of

Actions policy workflow path condition object

Parameters for an Actions policy workflow path condition. Omitting workflow_path when creating a policy targets all workflows without storing an explicit condition. Omitting it when updating a policy preserves the existing workflow targeting. For new or changed workflow conditions, the API requires at least one included or excluded pattern. This is validated server-side rather than by this schema, which can also describe existing stored conditions.

Properties of Actions policy workflow path condition

Nombre, Tipo, Descripción

workflow_path object Obligatorio

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

rules array of objects

An array of rules within the policy.

Can be one of these objects:

Nombre, Tipo, Descripción

restrict_actions_actors object

Choose specific actors that are authorized to trigger Actions workflows.

Properties of restrict_actions_actors

Nombre, Tipo, Descripción

type string Obligatorio

Valor: restrict_actions_actors

parameters object

Properties of parameters

Nombre, Tipo, Descripción

allowed_actors array of objects Obligatorio

Select the actors who can run Actions workflows.

Properties of allowed_actors

Nombre, Tipo, Descripción
`id` integer Obligatorio ID of the actor authorized to trigger Actions workflows.
`type` string Obligatorio The type of the actor Puede ser uno de los siguientes: `User`, `Bot`, `Team`, `BusinessTeam`, `EnterpriseTeam`, `IntegrationInstallation`, `App`, `RepositoryRole`

restrict_action_events object

Choose specific GitHub events that will trigger Actions workflows.

Properties of restrict_action_events

Nombre, Tipo, Descripción

type string Obligatorio

Valor: restrict_action_events

parameters object

Properties of parameters

Nombre, Tipo, Descripción

allowed_events array of strings Obligatorio

Códigos de estado de respuesta HTTP para "Create a repository Actions policy"

código de estado	Descripción
`201`	Created
`404`	Resource not found
`422`	Validation failed, or the endpoint has been spammed.
`500`	Internal Error

Ejemplos de código para "Create a repository Actions policy"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

post/repos/{owner}/{repo}/actions/policies

curl -L \
  -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/repos/OWNER/REPO/actions/policies \
  -d '{"name":"Require approved actors","enforcement":"active","rules":[{"type":"restrict_actions_actors","parameters":{"allowed_actors":[{"id":1234,"type":"Team"}]}}]}'

Response

Status: 201

{
  "id": 1,
  "name": "Restrict workflow modifications",
  "target": "actions",
  "source_type": "Enterprise",
  "source": "enterprise",
  "enforcement": "active",
  "conditions": {
    "organization_name": {
      "include": [
        "octo-org"
      ],
      "exclude": []
    },
    "repository_name": {
      "include": [
        "octo-repo"
      ],
      "exclude": []
    }
  },
  "rules": [
    {
      "type": "restrict_actions_actors",
      "parameters": {
        "allowed_actors": [
          {
            "id": 5,
            "type": "User"
          },
          {
            "id": 1234,
            "type": "Team"
          }
        ]
      }
    }
  ],
  "node_id": "RUL_lA",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Get a repository Actions policy

Get a specific Actions policy for a repository.

Tokens de acceso granulares para "Get a repository Actions policy"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Administration" repository permissions (write)

Parámetros para "Get a repository Actions policy"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`owner` string Obligatorio The account owner of the repository. The name is not case sensitive.
`repo` string Obligatorio The name of the repository without the `.git` extension. The name is not case sensitive.
`policy_id` integer Obligatorio The ID of the policy.

Códigos de estado de respuesta HTTP para "Get a repository Actions policy"

código de estado	Descripción
`200`	OK
`404`	Resource not found
`500`	Internal Error

Ejemplos de código para "Get a repository Actions policy"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

get/repos/{owner}/{repo}/actions/policies/{policy_id}

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/repos/OWNER/REPO/actions/policies/POLICY_ID

Response

Status: 200

{
  "id": 1,
  "name": "Restrict workflow modifications",
  "target": "actions",
  "source_type": "Enterprise",
  "source": "enterprise",
  "enforcement": "active",
  "conditions": {
    "organization_name": {
      "include": [
        "octo-org"
      ],
      "exclude": []
    },
    "repository_name": {
      "include": [
        "octo-repo"
      ],
      "exclude": []
    }
  },
  "rules": [
    {
      "type": "restrict_actions_actors",
      "parameters": {
        "allowed_actors": [
          {
            "id": 5,
            "type": "User"
          },
          {
            "id": 1234,
            "type": "Team"
          }
        ]
      }
    }
  ],
  "node_id": "RUL_lA",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Update a repository Actions policy

Update an Actions policy for a repository. Omitting workflow_path preserves the policy's existing workflow targeting.

Tokens de acceso granulares para "Update a repository Actions policy"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Administration" repository permissions (write)

Parámetros para "Update a repository Actions policy"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`owner` string Obligatorio The account owner of the repository. The name is not case sensitive.
`repo` string Obligatorio The name of the repository without the `.git` extension. The name is not case sensitive.
`policy_id` integer Obligatorio The ID of the policy.

Nombre, Tipo, Descripción

name string

The name of the policy.

enforcement string

Puede ser uno de los siguientes: disabled, active, evaluate

conditions object

Conditions for a repository Actions policy. The object may be empty to preserve or use the default workflow targeting, or contain only workflow_path.

Can be one of these objects:

Nombre, Tipo, Descripción

object

Properties of

Actions policy workflow path condition object

Properties of Actions policy workflow path condition

Nombre, Tipo, Descripción

workflow_path object Obligatorio

Properties of workflow_path

Nombre, Tipo, Descripción
`include` array of strings Obligatorio Array of workflow file paths or glob patterns to include. An empty array includes all workflows not matched by an excluded pattern. Use `~ALL` by itself to include all workflows. `~ALL` cannot be combined with other included patterns.
`exclude` array of strings Obligatorio Array of workflow file paths or glob patterns to exclude. The condition will not pass if any of these patterns match. `~ALL` is not allowed in this array.

rules array of objects

An array of rules within the policy.

Can be one of these objects:

Nombre, Tipo, Descripción

restrict_actions_actors object

Choose specific actors that are authorized to trigger Actions workflows.

Properties of restrict_actions_actors

Nombre, Tipo, Descripción

type string Obligatorio

Valor: restrict_actions_actors

parameters object

Properties of parameters

Nombre, Tipo, Descripción

allowed_actors array of objects Obligatorio

Select the actors who can run Actions workflows.

Properties of allowed_actors

Nombre, Tipo, Descripción
`id` integer Obligatorio ID of the actor authorized to trigger Actions workflows.
`type` string Obligatorio The type of the actor Puede ser uno de los siguientes: `User`, `Bot`, `Team`, `BusinessTeam`, `EnterpriseTeam`, `IntegrationInstallation`, `App`, `RepositoryRole`

restrict_action_events object

Choose specific GitHub events that will trigger Actions workflows.

Properties of restrict_action_events

Nombre, Tipo, Descripción

type string Obligatorio

Valor: restrict_action_events

parameters object

Properties of parameters

Nombre, Tipo, Descripción

allowed_events array of strings Obligatorio

Códigos de estado de respuesta HTTP para "Update a repository Actions policy"

código de estado	Descripción
`200`	OK
`404`	Resource not found
`422`	Validation failed, or the endpoint has been spammed.
`500`	Internal Error

Ejemplos de código para "Update a repository Actions policy"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

put/repos/{owner}/{repo}/actions/policies/{policy_id}

curl -L \
  -X PUT \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/repos/OWNER/REPO/actions/policies/POLICY_ID \
  -d '{"name":"Updated policy name","enforcement":"active"}'

Response

Status: 200

{
  "id": 1,
  "name": "Restrict workflow modifications",
  "target": "actions",
  "source_type": "Enterprise",
  "source": "enterprise",
  "enforcement": "active",
  "conditions": {
    "organization_name": {
      "include": [
        "octo-org"
      ],
      "exclude": []
    },
    "repository_name": {
      "include": [
        "octo-repo"
      ],
      "exclude": []
    }
  },
  "rules": [
    {
      "type": "restrict_actions_actors",
      "parameters": {
        "allowed_actors": [
          {
            "id": 5,
            "type": "User"
          },
          {
            "id": 1234,
            "type": "Team"
          }
        ]
      }
    }
  ],
  "node_id": "RUL_lA",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Delete a repository Actions policy

Delete an Actions policy for a repository.

Tokens de acceso granulares para "Delete a repository Actions policy"

Este punto de conexión funciona con los siguientes tipos de token pormenorizados:

El token pormenorizado debe tener el siguiente conjunto de permisos:

"Administration" repository permissions (write)

Parámetros para "Delete a repository Actions policy"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de ruta
Nombre, Tipo, Descripción
`owner` string Obligatorio The account owner of the repository. The name is not case sensitive.
`repo` string Obligatorio The name of the repository without the `.git` extension. The name is not case sensitive.
`policy_id` integer Obligatorio The ID of the policy.

Códigos de estado de respuesta HTTP para "Delete a repository Actions policy"

código de estado	Descripción
`204`	No Content
`404`	Resource not found
`500`	Internal Error

Ejemplos de código para "Delete a repository Actions policy"

Si accede a GitHub en GHE.com, reemplace api.github.com por el subdominio dedicado de la empresa en api.SUBDOMAIN.ghe.com.

Ejemplo de solicitud

delete/repos/{owner}/{repo}/actions/policies/{policy_id}

curl -L \
  -X DELETE \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/repos/OWNER/REPO/actions/policies/POLICY_ID

Response

Status: 204