repo sync

Author: Octomerger

content/actions/managing-workflow-runs/reviewing-deployments.md

@@ -13,7 +13,7 @@ versions:
 
 Jobs that reference an environment configured with required reviewers will wait for an approval before starting. While a job is awaiting approval, it has a status of "Waiting". If a job is not approved within 30 days, the workflow run will be automatically canceled.
 
-For more information about environments and required approvals, see "[Environments](/actions/reference/environments)."
+For more information about environments and required approvals, see "[Environments](/actions/reference/environments)." For information about how to review deployments with the REST API, see "[Workflow Runs](/rest/reference/actions#workflow-runs)."
 
 ### Approving or rejecting a job
 

content/actions/reference/environments.md

@@ -56,6 +56,8 @@ Secrets stored in an environment are only available to workflow jobs that refere
 1. Enter a name for the environment, then click **Configure environment**. Environment names are not case sensitive. An environment name may not exceed 255 characters and must be unique within the repository.
 1. Configure any environment protection rules or environment secrets.
 
+You can also create and configure environments through the REST API. For more information, see "[Environments](/rest/reference/repos#environments)" and "[Secrets](/rest/reference/actions#secrets)."
+
 Running a workflow that references an environment that does not exist will create an environment with the referenced name. The newly created environment will not have any protection rules or secrets configured. Anyone that can edit workflows in the repository can create environments via a workflow file, but only repository admins can configure the environment.
 
 ### Referencing an environment
@@ -77,3 +79,5 @@ Deleting an environment will delete all secrets and protection rules associated
 {% data reusables.github-actions.sidebar-environment %}
 1. Next the the environment that you want to delete, click {% octicon "trashcan" aria-label="The trashcan icon" %}.
 2. Click **I understand, delete this environment**.
+
+You can also delete environments through the REST API. For more information, see "[Environments](/rest/reference/repos#environments)."

content/rest/reference/repos.md

@@ -152,6 +152,15 @@ You can communicate that a transient environment no longer exists by setting its
   {% if operation.subcategory == 'deployments' %}{% include rest_operation %}{% endif %}
 {% endfor %}
 
+{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}
+## Environments
+
+The Environments API allows you to create, configure, and delete environments. For more information about environments, see "[Environments](/actions/reference/environments)."
+{% for operation in currentRestOperations %}
+  {% if operation.subcategory == 'environments' %}{% include rest_operation %}{% endif %}
+{% endfor %}
+{% endif %}
+
 ## Forks
 
 {% for operation in currentRestOperations %}

data/reusables/actions/about-secrets.md

@@ -1 +1 @@
-Encrypted secrets allow you to store sensitive information, such as access tokens, in your repository or organization.
+Encrypted secrets allow you to store sensitive information, such as access tokens, in your repository, repository environments, or organization.

data/reusables/webhooks/check_run_properties.md

@@ -6,6 +6,7 @@ Key | Type | Description
 `check_run[conclusion]`|`string` | The result of the completed check run. Can be one of `success`, `failure`, `neutral`, `cancelled`, `timed_out`,  {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" or currentVersion == "github-ae@latest" %}`action_required` or `stale`{% else %}or `action_required`{% endif %}. This value will be `null` until the check run has `completed`.
 `check_run[name]`|`string` | The name of the check run.
 `check_run[check_suite][id]`|`integer` | The id of the check suite that this check run is part of.
-`check_run[check_suite][pull_requests]`|`array`| An array of pull requests that match this check suite. A pull request matches a check suite if they have the same `head_sha` and `head_branch`. When the check suite's `head_branch` is in a forked repository it will be `null` and the `pull_requests` array will be empty.
+`check_run[check_suite][pull_requests]`|`array`| An array of pull requests that match this check suite. A pull request matches a check suite if they have the same `head_sha` and `head_branch`. When the check suite's `head_branch` is in a forked repository it will be `null` and the `pull_requests` array will be empty.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}
+`deployment`|`object`| A deployment to a repository environment. This will only be populated if the check run was created by a {% data variables.product.prodname_actions %} workflow job that references an environment.{% endif %}
 `requested_action`|`object` | The action requested by the user.
 `requested_action[identifier]`|`string` | The integrator reference of the action requested by the user.

lib/webhooks/static/dotcom/check_run.completed.payload.json

@@ -190,7 +190,20 @@
           }
         }
       }
-    ]
+    ],
+    "deployment": {
+      "url": "https://api.github.com/repos/Codertocat/Hello-World/deployments/326191728",
+      "id": 326191728,
+      "node_id": "MDEwOkRlcGxveW1lbnQzMjYxOTE3Mjg=",
+      "task": "deploy",
+      "original_environment": "lab",
+      "environment": "lab",
+      "description": null,
+      "created_at": "2021-02-18T08:22:48Z",
+      "updated_at": "2021-02-18T09:47:16Z",
+      "statuses_url": "https://api.github.com/repos/Codertocat/Hello-World/deployments/326191728/statuses",
+      "repository_url": "https://api.github.com/repos/Codertocat/Hello-World"
+    }
   },
   "repository": {
     "id": 186853002,

lib/webhooks/static/dotcom/check_run.created.payload.json

@@ -190,7 +190,20 @@
           }
         }
       }
-    ]
+    ],
+    "deployment": {
+      "url": "https://api.github.com/repos/Codertocat/Hello-World/deployments/326191728",
+      "id": 326191728,
+      "node_id": "MDEwOkRlcGxveW1lbnQzMjYxOTE3Mjg=",
+      "task": "deploy",
+      "original_environment": "lab",
+      "environment": "lab",
+      "description": null,
+      "created_at": "2021-02-18T08:22:48Z",
+      "updated_at": "2021-02-18T09:47:16Z",
+      "statuses_url": "https://api.github.com/repos/Codertocat/Hello-World/deployments/326191728/statuses",
+      "repository_url": "https://api.github.com/repos/Codertocat/Hello-World"
+    }
   },
   "repository": {
     "id": 186853002,

lib/webhooks/static/dotcom/check_run.rerequested.payload.json

@@ -95,7 +95,20 @@
     },
     "pull_requests": [
 
-    ]
+    ],
+    "deployment": {
+      "url": "https://api.github.com/repos/Codertocat/Hello-World/deployments/326191728",
+      "id": 326191728,
+      "node_id": "MDEwOkRlcGxveW1lbnQzMjYxOTE3Mjg=",
+      "task": "deploy",
+      "original_environment": "lab",
+      "environment": "lab",
+      "description": null,
+      "created_at": "2021-02-18T08:22:48Z",
+      "updated_at": "2021-02-18T09:47:16Z",
+      "statuses_url": "https://api.github.com/repos/Codertocat/Hello-World/deployments/326191728/statuses",
+      "repository_url": "https://api.github.com/repos/Codertocat/Hello-World"
+    }
   },
   "repository": {
     "id": 526,