fix(docs): update information on methods (#728)

docs/actions/listWorkflowRunsForRepo.md

@@ -14,6 +14,8 @@ Anyone with read access to the repository can use this endpoint.
 
 OAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint with a private repository.
 
+This API will return up to 1,000 results for each search when using the following parameters: `actor`, `branch`, `check_suite_id`, `created`, `event`, `head_sha`, `status`.
+
 ```js
 octokit.rest.actions.listWorkflowRunsForRepo({
   owner,

docs/orgs/createWebhook.md

@@ -8,7 +8,12 @@ type: API method
 
 # Create an organization webhook
 
-Here's how you can create a hook that posts payloads in JSON format:
+Create a hook that posts payloads in JSON format.
+
+You must be an organization owner to use this endpoint.
+
+OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or
+edit webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
 
 ```js
 octokit.rest.orgs.createWebhook({

docs/orgs/deleteWebhook.md

@@ -8,6 +8,11 @@ type: API method
 
 # Delete an organization webhook
 
+You must be an organization owner to use this endpoint.
+
+OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
 ```js
 octokit.rest.orgs.deleteWebhook({
   org,

docs/orgs/getWebhook.md

@@ -8,7 +8,13 @@ type: API method
 
 # Get an organization webhook
 
-Returns a webhook configured in an organization. To get only the webhook `config` properties, see "[Get a webhook configuration for an organization](/rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization)."
+Returns a webhook configured in an organization. To get only the webhook
+`config` properties, see "[Get a webhook configuration for an organization](/rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization).
+
+You must be an organization owner to use this endpoint.
+
+OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
 
 ```js
 octokit.rest.orgs.getWebhook({

docs/orgs/getWebhookConfigForOrg.md

@@ -10,7 +10,10 @@ type: API method
 
 Returns the webhook configuration for an organization. To get more information about the webhook, including the `active` state and `events`, use "[Get an organization webhook ](/rest/orgs/webhooks#get-an-organization-webhook)."
 
-OAuth app tokens and personal access tokens (classic) need the `admin:org_hook` scope to use this endpoint.
+You must be an organization owner to use this endpoint.
+
+OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
 
 ```js
 octokit.rest.orgs.getWebhookConfigForOrg({

docs/orgs/getWebhookDelivery.md

@@ -10,6 +10,11 @@ type: API method
 
 Returns a delivery for a webhook configured in an organization.
 
+You must be an organization owner to use this endpoint.
+
+OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
 ```js
 octokit.rest.orgs.getWebhookDelivery({
   org,

docs/orgs/listWebhookDeliveries.md

@@ -10,6 +10,11 @@ type: API method
 
 Returns a list of webhook deliveries for a webhook configured in an organization.
 
+You must be an organization owner to use this endpoint.
+
+OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
 ```js
 octokit.rest.orgs.listWebhookDeliveries({
   org,

docs/orgs/listWebhooks.md

@@ -8,6 +8,11 @@ type: API method
 
 # List organization webhooks
 
+You must be an organization owner to use this endpoint.
+
+OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
 ```js
 octokit.rest.orgs.listWebhooks({
   org,

docs/orgs/pingWebhook.md

@@ -8,7 +8,13 @@ type: API method
 
 # Ping an organization webhook
 
-This will trigger a [ping event](https://docs.github.com/webhooks/#ping-event) to be sent to the hook.
+This will trigger a [ping event](https://docs.github.com/webhooks/#ping-event)
+to be sent to the hook.
+
+You must be an organization owner to use this endpoint.
+
+OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
 
 ```js
 octokit.rest.orgs.pingWebhook({

docs/orgs/redeliverWebhookDelivery.md

@@ -10,6 +10,11 @@ type: API method
 
 Redeliver a delivery for a webhook configured in an organization.
 
+You must be an organization owner to use this endpoint.
+
+OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
+
 ```js
 octokit.rest.orgs.redeliverWebhookDelivery({
   org,

docs/orgs/updateWebhook.md

@@ -8,7 +8,16 @@ type: API method
 
 # Update an organization webhook
 
-Updates a webhook configured in an organization. When you update a webhook, the `secret` will be overwritten. If you previously had a `secret` set, you must provide the same `secret` or set a new `secret` or the secret will be removed. If you are only updating individual webhook `config` properties, use "[Update a webhook configuration for an organization](/rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization)."
+Updates a webhook configured in an organization. When you update a webhook,
+the `secret` will be overwritten. If you previously had a `secret` set, you must
+provide the same `secret` or set a new `secret` or the secret will be removed. If
+you are only updating individual webhook `config` properties, use "[Update a webhook
+configuration for an organization](/rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization)".
+
+You must be an organization owner to use this endpoint.
+
+OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
 
 ```js
 octokit.rest.orgs.updateWebhook({

docs/orgs/updateWebhookConfigForOrg.md

@@ -10,7 +10,10 @@ type: API method
 
 Updates the webhook configuration for an organization. To update more information about the webhook, including the `active` state and `events`, use "[Update an organization webhook ](/rest/orgs/webhooks#update-an-organization-webhook)."
 
-OAuth app tokens and personal access tokens (classic) need the `admin:org_hook` scope to use this endpoint.
+You must be an organization owner to use this endpoint.
+
+OAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit
+webhooks that they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.
 
 ```js
 octokit.rest.orgs.updateWebhookConfigForOrg({

package.json

@@ -25,7 +25,7 @@
   "author": "Gregor Martynus (https://twitter.com/gr2m)",
   "license": "MIT",
   "dependencies": {
-    "@octokit/types": "^13.1.0"
+    "@octokit/types": "^13.3.0"
   },
   "devDependencies": {
     "@octokit/core": "^6.0.0",