Update OpenAPI Description (#61144)

Co-authored-by: Sophie <29382425+sophietheking@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
docs-bot · May 11, 2026 · May 11, 2026 · May 11, 2026 · May 11, 2026 · May 11, 2026
commit fce496af7b78c3a8523d42a0483198772863cb35
diff --git a/content/rest/actions/concurrency-groups.md b/content/rest/actions/concurrency-groups.md
@@ -1,7 +1,9 @@
 ---
 title: REST API endpoints for Actions concurrency groups
 shortTitle: Actions concurrency groups
-intro: Use the REST API to view and manage concurrency groups for GitHub Actions workflows.
+intro: >-
+  Use the REST API to view and manage concurrency groups for GitHub Actions
+  workflows.
 versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖
   fpt: '*'
   ghec: '*'
@@ -15,4 +17,4 @@ category:
 
 You can use the REST API to read the state of {% data variables.product.prodname_actions %} concurrency groups, which ensure that only a single job or workflow using the same group will run at a time while additional runs are pending or canceled depending on configuration. For more information, see [AUTOTITLE](/actions/using-jobs/using-concurrency).
 
-<!-- Content after this section is automatically generated -->
+<!-- Content after this section is automatically generated -->
diff --git a/content/rest/agents/index.md b/content/rest/agents/index.md
@@ -0,0 +1,12 @@
+---
+title: REST endpoints for agents
+autogenerated: rest
+allowTitleToDifferFromFilename: true
+children:
+  - /secrets
+  - /variables
+versions:
+  fpt: '*'
+  ghec: '*'
+---
+
diff --git a/content/rest/agents/secrets.md b/content/rest/agents/secrets.md
@@ -0,0 +1,12 @@
+---
+title: REST API endpoints for agent secrets
+shortTitle: Secrets
+intro: Use the REST API to manage secrets for agents.
+versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖
+  fpt: '*'
+  ghec: '*'
+autogenerated: rest
+allowTitleToDifferFromFilename: true
+---
+
+<!-- Content after this section is automatically generated -->
diff --git a/content/rest/agents/variables.md b/content/rest/agents/variables.md
@@ -0,0 +1,12 @@
+---
+title: REST API endpoints for variables
+shortTitle: Variables
+intro: Use the REST API to manage variables.
+versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖
+  fpt: '*'
+  ghec: '*'
+autogenerated: rest
+allowTitleToDifferFromFilename: true
+---
+
+<!-- Content after this section is automatically generated -->
diff --git a/content/rest/index.md b/content/rest/index.md
@@ -50,6 +50,7 @@ children:
   - /actions
   - /activity
   - /agent-tasks
+  - /agents
   - /announcement-banners
   - /apps
   - /billing

diff --git a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json
@@ -983,6 +983,180 @@
       }
     ]
   },
+  "organization_agent_secrets": {
+    "title": "Agent secrets",
+    "displayTitle": "Organization permissions for \"Agent secrets\"",
+    "permissions": [
+      {
+        "category": "agents",
+        "slug": "list-organization-secrets",
+        "subcategory": "secrets",
+        "verb": "get",
+        "requestPath": "/orgs/{org}/agents/secrets",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "agents",
+        "slug": "get-an-organization-public-key",
+        "subcategory": "secrets",
+        "verb": "get",
+        "requestPath": "/orgs/{org}/agents/secrets/public-key",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "agents",
+        "slug": "get-an-organization-secret",
+        "subcategory": "secrets",
+        "verb": "get",
+        "requestPath": "/orgs/{org}/agents/secrets/{secret_name}",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "agents",
+        "slug": "create-or-update-an-organization-secret",
+        "subcategory": "secrets",
+        "verb": "put",
+        "requestPath": "/orgs/{org}/agents/secrets/{secret_name}",
+        "additional-permissions": false,
+        "access": "write"
+      },
+      {
+        "category": "agents",
+        "slug": "delete-an-organization-secret",
+        "subcategory": "secrets",
+        "verb": "delete",
+        "requestPath": "/orgs/{org}/agents/secrets/{secret_name}",
+        "additional-permissions": false,
+        "access": "write"
+      },
+      {
+        "category": "agents",
+        "slug": "list-selected-repositories-for-an-organization-secret",
+        "subcategory": "secrets",
+        "verb": "get",
+        "requestPath": "/orgs/{org}/agents/secrets/{secret_name}/repositories",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "agents",
+        "slug": "set-selected-repositories-for-an-organization-secret",
+        "subcategory": "secrets",
+        "verb": "put",
+        "requestPath": "/orgs/{org}/agents/secrets/{secret_name}/repositories",
+        "additional-permissions": false,
+        "access": "write"
+      },
+      {
+        "category": "agents",
+        "slug": "add-selected-repository-to-an-organization-secret",
+        "subcategory": "secrets",
+        "verb": "put",
+        "requestPath": "/orgs/{org}/agents/secrets/{secret_name}/repositories/{repository_id}",
+        "additional-permissions": true,
+        "access": "write"
+      },
+      {
+        "category": "agents",
+        "slug": "remove-selected-repository-from-an-organization-secret",
+        "subcategory": "secrets",
+        "verb": "delete",
+        "requestPath": "/orgs/{org}/agents/secrets/{secret_name}/repositories/{repository_id}",
+        "additional-permissions": true,
+        "access": "write"
+      }
+    ]
+  },
+  "organization_agent_variables": {
+    "title": "Agent variables",
+    "displayTitle": "Organization permissions for \"Agent variables\"",
+    "permissions": [
+      {
+        "category": "agents",
+        "slug": "list-organization-variables",
+        "subcategory": "variables",
+        "verb": "get",
+        "requestPath": "/orgs/{org}/agents/variables",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "agents",
+        "slug": "create-an-organization-variable",
+        "subcategory": "variables",
+        "verb": "post",
+        "requestPath": "/orgs/{org}/agents/variables",
+        "additional-permissions": false,
+        "access": "write"
+      },
+      {
+        "category": "agents",
+        "slug": "get-an-organization-variable",
+        "subcategory": "variables",
+        "verb": "get",
+        "requestPath": "/orgs/{org}/agents/variables/{name}",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "agents",
+        "slug": "update-an-organization-variable",
+        "subcategory": "variables",
+        "verb": "patch",
+        "requestPath": "/orgs/{org}/agents/variables/{name}",
+        "additional-permissions": false,
+        "access": "write"
+      },
+      {
+        "category": "agents",
+        "slug": "delete-an-organization-variable",
+        "subcategory": "variables",
+        "verb": "delete",
+        "requestPath": "/orgs/{org}/agents/variables/{name}",
+        "additional-permissions": false,
+        "access": "write"
+      },
+      {
+        "category": "agents",
+        "slug": "list-selected-repositories-for-an-organization-variable",
+        "subcategory": "variables",
+        "verb": "get",
+        "requestPath": "/orgs/{org}/agents/variables/{name}/repositories",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "agents",
+        "slug": "set-selected-repositories-for-an-organization-variable",
+        "subcategory": "variables",
+        "verb": "put",
+        "requestPath": "/orgs/{org}/agents/variables/{name}/repositories",
+        "additional-permissions": false,
+        "access": "write"
+      },
+      {
+        "category": "agents",
+        "slug": "add-selected-repository-to-an-organization-variable",
+        "subcategory": "variables",
+        "verb": "put",
+        "requestPath": "/orgs/{org}/agents/variables/{name}/repositories/{repository_id}",
+        "additional-permissions": true,
+        "access": "write"
+      },
+      {
+        "category": "agents",
+        "slug": "remove-selected-repository-from-an-organization-variable",
+        "subcategory": "variables",
+        "verb": "delete",
+        "requestPath": "/orgs/{org}/agents/variables/{name}/repositories/{repository_id}",
+        "additional-permissions": true,
+        "access": "write"
+      }
+    ]
+  },
   "organization_user_blocking": {
     "title": "Blocking users",
     "displayTitle": "Organization permissions for \"Blocking users\"",
@@ -4835,6 +5009,126 @@
       }
     ]
   },
+  "agent_secrets": {
+    "title": "Agent secrets",
+    "displayTitle": "Repository permissions for \"Agent secrets\"",
+    "permissions": [
+      {
+        "category": "agents",
+        "slug": "list-repository-organization-secrets",
+        "subcategory": "secrets",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/agents/organization-secrets",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "agents",
+        "slug": "list-repository-secrets",
+        "subcategory": "secrets",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/agents/secrets",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "agents",
+        "slug": "get-a-repository-public-key",
+        "subcategory": "secrets",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/agents/secrets/public-key",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "agents",
+        "slug": "get-a-repository-secret",
+        "subcategory": "secrets",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/agents/secrets/{secret_name}",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "agents",
+        "slug": "create-or-update-a-repository-secret",
+        "subcategory": "secrets",
+        "verb": "put",
+        "requestPath": "/repos/{owner}/{repo}/agents/secrets/{secret_name}",
+        "additional-permissions": false,
+        "access": "write"
+      },
+      {
+        "category": "agents",
+        "slug": "delete-a-repository-secret",
+        "subcategory": "secrets",
+        "verb": "delete",
+        "requestPath": "/repos/{owner}/{repo}/agents/secrets/{secret_name}",
+        "additional-permissions": false,
+        "access": "write"
+      }
+    ]
+  },
+  "agent_variables": {
+    "title": "Agent variables",
+    "displayTitle": "Repository permissions for \"Agent variables\"",
+    "permissions": [
+      {
+        "category": "agents",
+        "slug": "list-repository-organization-variables",
+        "subcategory": "variables",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/agents/organization-variables",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "agents",
+        "slug": "list-repository-variables",
+        "subcategory": "variables",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/agents/variables",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "agents",
+        "slug": "create-a-repository-variable",
+        "subcategory": "variables",
+        "verb": "post",
+        "requestPath": "/repos/{owner}/{repo}/agents/variables",
+        "additional-permissions": false,
+        "access": "write"
+      },
+      {
+        "category": "agents",
+        "slug": "get-a-repository-variable",
+        "subcategory": "variables",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/agents/variables/{name}",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "agents",
+        "slug": "update-a-repository-variable",
+        "subcategory": "variables",
+        "verb": "patch",
+        "requestPath": "/repos/{owner}/{repo}/agents/variables/{name}",
+        "additional-permissions": false,
+        "access": "write"
+      },
+      {
+        "category": "agents",
+        "slug": "delete-a-repository-variable",
+        "subcategory": "variables",
+        "verb": "delete",
+        "requestPath": "/repos/{owner}/{repo}/agents/variables/{name}",
+        "additional-permissions": false,
+        "access": "write"
+      }
+    ]
+  },
   "artifact_metadata": {
     "title": "Artifact metadata",
     "displayTitle": "Repository permissions for \"Artifact metadata\"",