org_fork_pr_contributor_approval_permissions
Creates, updates, deletes, gets or lists an org_fork_pr_contributor_approval_permissions resource.
Overview
| Name | org_fork_pr_contributor_approval_permissions |
| Type | Resource |
| Id | github.actions.org_fork_pr_contributor_approval_permissions |
Fields
The following fields are returned by SELECT queries:
- get_fork_pr_contributor_approval_permissions_organization
Response
| Name | Datatype | Description |
|---|---|---|
approval_policy | string | The policy that controls when fork PR workflows require approval from a maintainer. (first_time_contributors_new_to_github, first_time_contributors, all_external_contributors) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_fork_pr_contributor_approval_permissions_organization | select | org | Gets the fork PR contributor approval policy for an organization. OAuth app tokens and personal access tokens (classic) need the admin:org scope or the "Actions policies" fine-grained permission to use this endpoint. | |
set_fork_pr_contributor_approval_permissions_organization | replace | org, approval_policy | Sets the fork PR contributor approval policy for an organization. OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
org | string | The organization name. The name is not case sensitive. |
SELECT examples
- get_fork_pr_contributor_approval_permissions_organization
Gets the fork PR contributor approval policy for an organization.
OAuth app tokens and personal access tokens (classic) need the admin:org scope or the "Actions policies" fine-grained permission to use this endpoint.
SELECT
approval_policy
FROM github.actions.org_fork_pr_contributor_approval_permissions
WHERE org = '{{ org }}' -- required
;
REPLACE examples
- set_fork_pr_contributor_approval_permissions_organization
Sets the fork PR contributor approval policy for an organization.
OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.
REPLACE github.actions.org_fork_pr_contributor_approval_permissions
SET
approval_policy = '{{ approval_policy }}'
WHERE
org = '{{ org }}' --required
AND approval_policy = '{{ approval_policy }}' --required;