@octokit/openapi 18.1.0 → 18.2.0

package/generated/api.github.com.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "18.1.0",
+    "version": "18.2.0",
     "title": "GitHub's official OpenAPI spec + Octokit extension",
     "description": "OpenAPI specs from https://github.com/github/rest-api-description with the 'x-octokit' extension required by the Octokit SDKs",
     "license": {
@@ -16935,6 +16935,234 @@
         "x-octokit": {}
       }
     },
+    "/orgs/{org}/issue-types": {
+      "get": {
+        "summary": "List issue types for an organization",
+        "description": "Lists all issue types for an organization.",
+        "tags": [
+          "orgs"
+        ],
+        "operationId": "orgs/list-issue-types",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/orgs/issue-types#list-issue-types-for-an-organization"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/org"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/issue-type"
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/issue-type-items"
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "$ref": "#/components/responses/not_found"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "orgs",
+          "subcategory": "issue-types"
+        },
+        "x-octokit": {}
+      },
+      "post": {
+        "summary": "Create issue type for an organization",
+        "description": "Create a new issue type for an organization.\n\nYou can find out more about issue types in [Managing issue types in an organization](https://docs.github.com/issues/tracking-your-work-with-issues/configuring-issues/managing-issue-types-in-an-organization).",
+        "tags": [
+          "orgs"
+        ],
+        "operationId": "orgs/create-issue-type",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/orgs/issue-types#create-issue-type-for-an-organization"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/org"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/organization-create-issue-type"
+              },
+              "examples": {
+                "default": {
+                  "value": {
+                    "name": "Epic",
+                    "description": "An issue type for a multi-week tracking of work",
+                    "is_enabled": true,
+                    "color": "green",
+                    "is_private": true
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/issue-type"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/issue-type"
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "$ref": "#/components/responses/not_found"
+          },
+          "422": {
+            "$ref": "#/components/responses/validation_failed_simple"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "orgs",
+          "subcategory": "issue-types"
+        },
+        "x-octokit": {}
+      }
+    },
+    "/orgs/{org}/issue-types/{issue_type_id}": {
+      "put": {
+        "summary": "Update issue type for an organization",
+        "description": "Updates an issue type for an organization.\n\nYou can find out more about issue types in [Managing issue types in an organization](https://docs.github.com/issues/tracking-your-work-with-issues/configuring-issues/managing-issue-types-in-an-organization).",
+        "tags": [
+          "orgs"
+        ],
+        "operationId": "orgs/update-issue-type",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/orgs/issue-types#update-issue-type-for-an-organization"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/org"
+          },
+          {
+            "$ref": "#/components/parameters/issue-type-id"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/organization-update-issue-type"
+              },
+              "examples": {
+                "default": {
+                  "value": {
+                    "name": "Epic",
+                    "description": "An issue type for a multi-week tracking of work",
+                    "is_enabled": true,
+                    "color": "green",
+                    "is_private": true
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/issue-type"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/issue-type"
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "$ref": "#/components/responses/not_found"
+          },
+          "422": {
+            "$ref": "#/components/responses/validation_failed_simple"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "orgs",
+          "subcategory": "issue-types"
+        },
+        "x-octokit": {}
+      },
+      "delete": {
+        "summary": "Delete issue type for an organization",
+        "description": "Deletes an issue type for an organization.\n\nYou can find out more about issue types in [Managing issue types in an organization](https://docs.github.com/issues/tracking-your-work-with-issues/configuring-issues/managing-issue-types-in-an-organization).",
+        "tags": [
+          "orgs"
+        ],
+        "operationId": "orgs/delete-issue-type",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/orgs/issue-types#delete-issue-type-for-an-organization"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/org"
+          },
+          {
+            "$ref": "#/components/parameters/issue-type-id"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Response"
+          },
+          "404": {
+            "$ref": "#/components/responses/not_found"
+          },
+          "422": {
+            "$ref": "#/components/responses/validation_failed_simple"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "orgs",
+          "subcategory": "issue-types"
+        },
+        "x-octokit": {}
+      }
+    },
     "/orgs/{org}/issues": {
       "get": {
         "summary": "List organization issues assigned to the authenticated user",
@@ -16987,6 +17215,15 @@
           {
             "$ref": "#/components/parameters/labels"
           },
+          {
+            "name": "type",
+            "description": "Can be the name of an issue type.",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
           {
             "name": "sort",
             "description": "What to sort results by.",
@@ -19303,6 +19540,9 @@
           },
           {
             "$ref": "#/components/parameters/personal-access-token-after"
+          },
+          {
+            "$ref": "#/components/parameters/personal-access-token-token-id"
           }
         ],
         "responses": {
@@ -19650,6 +19890,9 @@
           },
           {
             "$ref": "#/components/parameters/personal-access-token-after"
+          },
+          {
+            "$ref": "#/components/parameters/personal-access-token-token-id"
           }
         ],
         "responses": {
@@ -20612,7 +20855,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an organization",
-        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
+        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
         "tags": [
           "orgs"
         ],
@@ -39128,7 +39371,7 @@
       },
       "put": {
         "summary": "Create or update a repository secret",
-        "description": "Creates or updates a repository development environment secret with an encrypted value. Encrypt your secret using\n[LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages). For more information, see \"[Encrypting secrets for the REST API](https://docs.github.com/rest/guides/encrypting-secrets-for-the-rest-api).\"\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
+        "description": "Creates or updates a repository development environment secret with an encrypted value. Encrypt your secret using\n[LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages). For more information, see \"[Encrypting secrets for the REST API](https://docs.github.com/rest/guides/encrypting-secrets-for-the-rest-api).\"\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint. The associated user must be a repository admin.",
         "tags": [
           "codespaces"
         ],
@@ -39207,7 +39450,7 @@
       },
       "delete": {
         "summary": "Delete a repository secret",
-        "description": "Deletes a development environment secret in a repository using the secret name.\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
+        "description": "Deletes a development environment secret in a repository using the secret name.\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint. The associated user must be a repository admin.",
         "tags": [
           "codespaces"
         ],
@@ -43600,7 +43843,7 @@
       },
       "post": {
         "summary": "Create a custom deployment protection rule on an environment",
-        "description": "Enable a custom deployment protection rule for an environment.\n\nThe authenticated user must have admin or owner permissions to the repository to use this endpoint.\n\nFor more information about the app that is providing this custom deployment rule, see the [documentation for the `GET /apps/{app_slug}` endpoint](https://docs.github.com/rest/apps/apps#get-an-app).\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
+        "description": "Enable a custom deployment protection rule for an environment.\n\nThe authenticated user must have admin or owner permissions to the repository to use this endpoint.\n\nFor more information about the app that is providing this custom deployment rule, see the [documentation for the `GET /apps/{app_slug}` endpoint](https://docs.github.com/rest/apps/apps#get-an-app), as well as the [guide to creating custom deployment protection rules](https://docs.github.com/actions/managing-workflow-runs-and-deployments/managing-deployments/creating-custom-deployment-protection-rules).\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
         "tags": [
           "repos"
         ],
@@ -47621,6 +47864,15 @@
               "type": "string"
             }
           },
+          {
+            "name": "type",
+            "description": "Can be the name of an issue type. If the string `*` is passed, issues with any type are accepted. If the string `none` is passed, issues without type are returned.",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
           {
             "name": "creator",
             "description": "The user that created the issue.",
@@ -47806,6 +48058,12 @@
                     "items": {
                       "type": "string"
                     }
+                  },
+                  "type": {
+                    "type": "string",
+                    "description": "The name of the issue type to associate with this issue.",
+                    "nullable": true,
+                    "example": "Epic"
                   }
                 },
                 "required": [
@@ -48661,6 +48919,12 @@
                     "items": {
                       "type": "string"
                     }
+                  },
+                  "type": {
+                    "type": "string",
+                    "description": "The name of the issue type to associate with this issue or use `null` to remove the current issue type.",
+                    "nullable": true,
+                    "example": "Epic"
                   }
                 }
               },
@@ -60940,7 +61204,7 @@
     "/search/issues": {
       "get": {
         "summary": "Search issues and pull requests",
-        "description": "> [!WARNING]\n> **Notice:** Search for issues and pull requests will be overridden by advanced search on September 4, 2025.",
+        "description": "> [!WARNING]\n> **Notice:** Search for issues and pull requests will be overridden by advanced search on September 4, 2025.\n> You can read more about this change on [the GitHub blog](https://github.blog/changelog/2025-03-06-github-issues-projects-api-support-for-issues-advanced-search-and-more/).",
         "tags": [
           "search"
         ],
@@ -96821,6 +97085,7 @@
           "id": {
             "description": "Unique identifier of the webhook delivery.",
             "type": "integer",
+            "format": "int64",
             "example": 42
           },
           "guid": {
@@ -96868,12 +97133,14 @@
           "installation_id": {
             "description": "The id of the GitHub App installation associated with this event.",
             "type": "integer",
+            "format": "int64",
             "example": 123,
             "nullable": true
           },
           "repository_id": {
             "description": "The id of the repository associated with this event.",
             "type": "integer",
+            "format": "int64",
             "example": 123,
             "nullable": true
           },
@@ -97215,7 +97482,7 @@
           },
           "dependabot_secrets": {
             "type": "string",
-            "description": "The leve of permission to grant the access token to manage Dependabot secrets.",
+            "description": "The level of permission to grant the access token to manage Dependabot secrets.",
             "enum": [
               "read",
               "write"
@@ -100546,6 +100813,66 @@
         ],
         "nullable": true
       },
+      "issue-type": {
+        "title": "Issue Type",
+        "description": "The type of issue.",
+        "type": "object",
+        "nullable": true,
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "The unique identifier of the issue type."
+          },
+          "node_id": {
+            "type": "string",
+            "description": "The node identifier of the issue type."
+          },
+          "name": {
+            "type": "string",
+            "description": "The name of the issue type."
+          },
+          "description": {
+            "type": "string",
+            "description": "The description of the issue type.",
+            "nullable": true
+          },
+          "color": {
+            "type": "string",
+            "description": "The color of the issue type.",
+            "enum": [
+              "gray",
+              "blue",
+              "green",
+              "yellow",
+              "orange",
+              "red",
+              "pink",
+              "purple"
+            ],
+            "nullable": true
+          },
+          "created_at": {
+            "type": "string",
+            "description": "The time the issue type created.",
+            "format": "date-time"
+          },
+          "updated_at": {
+            "type": "string",
+            "description": "The time the issue type last updated.",
+            "format": "date-time"
+          },
+          "is_enabled": {
+            "type": "boolean",
+            "description": "The enabled state of the issue type."
+          }
+        },
+        "required": [
+          "id",
+          "node_id",
+          "name",
+          "description"
+        ]
+      },
       "nullable-integration": {
         "title": "GitHub app",
         "description": "GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They come with granular permissions and built-in webhooks. GitHub apps are first class actors within GitHub.",
@@ -100972,6 +101299,9 @@
             "type": "string",
             "format": "uri"
           },
+          "type": {
+            "$ref": "#/components/schemas/issue-type"
+          },
           "repository": {
             "$ref": "#/components/schemas/repository"
           },
@@ -104206,12 +104536,12 @@
         "type": "object",
         "properties": {
           "id": {
-            "description": "The id of the runner.",
+            "description": "The ID of the runner.",
             "type": "integer",
             "example": 5
           },
           "runner_group_id": {
-            "description": "The id of the runner group.",
+            "description": "The ID of the runner group.",
             "type": "integer",
             "example": 1
           },
@@ -106971,6 +107301,88 @@
           "limit"
         ]
       },
+      "organization-create-issue-type": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "description": "Name of the issue type.",
+            "type": "string"
+          },
+          "is_enabled": {
+            "description": "Whether or not the issue type is enabled at the organization level.",
+            "type": "boolean"
+          },
+          "is_private": {
+            "description": "Whether or not the issue type is restricted to issues in private repositories.",
+            "type": "boolean"
+          },
+          "description": {
+            "description": "Description of the issue type.",
+            "type": "string",
+            "nullable": true
+          },
+          "color": {
+            "description": "Color for the issue type.",
+            "type": "string",
+            "enum": [
+              "gray",
+              "blue",
+              "green",
+              "yellow",
+              "orange",
+              "red",
+              "pink",
+              "purple"
+            ],
+            "nullable": true
+          }
+        },
+        "required": [
+          "name",
+          "is_enabled"
+        ]
+      },
+      "organization-update-issue-type": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "description": "Name of the issue type.",
+            "type": "string"
+          },
+          "is_enabled": {
+            "description": "Whether or not the issue type is enabled at the organization level.",
+            "type": "boolean"
+          },
+          "is_private": {
+            "description": "Whether or not the issue type is restricted to issues in private repositories.",
+            "type": "boolean"
+          },
+          "description": {
+            "description": "Description of the issue type.",
+            "type": "string",
+            "nullable": true
+          },
+          "color": {
+            "description": "Color for the issue type.",
+            "type": "string",
+            "enum": [
+              "gray",
+              "blue",
+              "green",
+              "yellow",
+              "orange",
+              "red",
+              "pink",
+              "purple"
+            ],
+            "nullable": true
+          }
+        },
+        "required": [
+          "name",
+          "is_enabled"
+        ]
+      },
       "org-membership": {
         "title": "Org Membership",
         "description": "Org Membership",
@@ -108157,6 +108569,16 @@
             "maxItems": 200,
             "nullable": true,
             "description": "An ordered list of the allowed values of the property.\nThe property can have up to 200 allowed values."
+          },
+          "values_editable_by": {
+            "type": "string",
+            "nullable": true,
+            "enum": [
+              "org_actors",
+              "org_and_repo_actors"
+            ],
+            "example": "org_actors",
+            "description": "Who can edit the values of the property"
           }
         },
         "required": [
@@ -121479,6 +121901,9 @@
             "type": "string",
             "format": "uri"
           },
+          "type": {
+            "$ref": "#/components/schemas/issue-type"
+          },
           "repository": {
             "$ref": "#/components/schemas/repository"
           },
@@ -127360,6 +127785,9 @@
             "type": "string",
             "format": "uri"
           },
+          "type": {
+            "$ref": "#/components/schemas/issue-type"
+          },
           "performed_via_github_app": {
             "$ref": "#/components/schemas/nullable-integration"
           },
@@ -133378,6 +133806,9 @@
             "description": "Title of the issue",
             "type": "string"
           },
+          "type": {
+            "$ref": "#/components/schemas/issue-type"
+          },
           "updated_at": {
             "type": "string",
             "format": "date-time"
@@ -134769,6 +135200,9 @@
             "description": "Title of the issue",
             "type": "string"
           },
+          "type": {
+            "$ref": "#/components/schemas/issue-type"
+          },
           "updated_at": {
             "type": "string",
             "format": "date-time"
@@ -158832,6 +159266,9 @@
                     "description": "Title of the issue",
                     "type": "string"
                   },
+                  "type": {
+                    "$ref": "#/components/schemas/issue-type"
+                  },
                   "updated_at": {
                     "type": "string",
                     "format": "date-time"
@@ -160414,6 +160851,9 @@
                     "description": "Title of the issue",
                     "type": "string"
                   },
+                  "type": {
+                    "$ref": "#/components/schemas/issue-type"
+                  },
                   "updated_at": {
                     "type": "string",
                     "format": "date-time"
@@ -162005,6 +162445,9 @@
                     "description": "Title of the issue",
                     "type": "string"
                   },
+                  "type": {
+                    "$ref": "#/components/schemas/issue-type"
+                  },
                   "updated_at": {
                     "type": "string",
                     "format": "date-time"
@@ -163630,6 +164073,9 @@
                     "description": "Title of the issue",
                     "type": "string"
                   },
+                  "type": {
+                    "$ref": "#/components/schemas/issue-type"
+                  },
                   "updated_at": {
                     "type": "string",
                     "format": "date-time"
@@ -165071,6 +165517,9 @@
                 "description": "Title of the issue",
                 "type": "string"
               },
+              "type": {
+                "$ref": "#/components/schemas/issue-type"
+              },
               "updated_at": {
                 "type": "string",
                 "format": "date-time"
@@ -166333,6 +166782,9 @@
                 "description": "Title of the issue",
                 "type": "string"
               },
+              "type": {
+                "$ref": "#/components/schemas/issue-type"
+              },
               "updated_at": {
                 "type": "string",
                 "format": "date-time"
@@ -167584,6 +168036,9 @@
                 "type": "string",
                 "format": "uri"
               },
+              "type": {
+                "$ref": "#/components/schemas/issue-type"
+              },
               "title": {
                 "description": "Title of the issue",
                 "type": "string"
@@ -168832,6 +169287,9 @@
                 "type": "string",
                 "format": "uri"
               },
+              "type": {
+                "$ref": "#/components/schemas/issue-type"
+              },
               "title": {
                 "description": "Title of the issue",
                 "type": "string"
@@ -170106,6 +170564,9 @@
                 "type": "string",
                 "format": "uri"
               },
+              "type": {
+                "$ref": "#/components/schemas/issue-type"
+              },
               "title": {
                 "description": "Title of the issue",
                 "type": "string"
@@ -171348,6 +171809,9 @@
                 "description": "Title of the issue",
                 "type": "string"
               },
+              "type": {
+                "$ref": "#/components/schemas/issue-type"
+              },
               "updated_at": {
                 "type": "string",
                 "format": "date-time"
@@ -174396,6 +174860,9 @@
                 "description": "Title of the issue",
                 "type": "string"
               },
+              "type": {
+                "$ref": "#/components/schemas/issue-type"
+              },
               "updated_at": {
                 "type": "string",
                 "format": "date-time"
@@ -175802,6 +176269,9 @@
                     "type": "string"
                   }
                 }
+              },
+              "type": {
+                "$ref": "#/components/schemas/issue-type"
               }
             }
           },
@@ -176912,6 +177382,9 @@
                     "description": "Title of the issue",
                     "type": "string"
                   },
+                  "type": {
+                    "$ref": "#/components/schemas/issue-type"
+                  },
                   "updated_at": {
                     "type": "string",
                     "format": "date-time"
@@ -178882,6 +179355,9 @@
                 "description": "Title of the issue",
                 "type": "string"
               },
+              "type": {
+                "$ref": "#/components/schemas/issue-type"
+              },
               "updated_at": {
                 "type": "string",
                 "format": "date-time"
@@ -276687,6 +277163,36 @@
           }
         ]
       },
+      "issue-type-items": {
+        "value": [
+          {
+            "id": 410,
+            "node_id": "IT_kwDNAd3NAZo",
+            "name": "Task",
+            "description": "A specific piece of work",
+            "created_at": "2024-12-11T14:39:09Z",
+            "updated_at": "2024-12-11T14:39:09Z"
+          },
+          {
+            "id": 411,
+            "node_id": "IT_kwDNAd3NAZs",
+            "name": "Bug",
+            "description": "An unexpected problem or behavior",
+            "created_at": "2024-12-11T14:39:09Z",
+            "updated_at": "2024-12-11T14:39:09Z"
+          }
+        ]
+      },
+      "issue-type": {
+        "value": {
+          "id": 410,
+          "node_id": "IT_kwDNAd3NAZo",
+          "name": "Task",
+          "description": "A specific piece of work",
+          "created_at": "2024-12-11T14:39:09Z",
+          "updated_at": "2024-12-11T14:39:09Z"
+        }
+      },
       "codespace": {
         "value": {
           "id": 1,
@@ -300498,6 +301004,15 @@
           "type": "integer"
         }
       },
+      "issue-type-id": {
+        "name": "issue_type_id",
+        "description": "The unique identifier of the issue type.",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "integer"
+        }
+      },
       "codespace-name": {
         "name": "codespace_name",
         "in": "path",
@@ -300659,6 +301174,20 @@
           "format": "date-time"
         }
       },
+      "personal-access-token-token-id": {
+        "name": "token_id",
+        "description": "The ID of the token",
+        "in": "query",
+        "required": false,
+        "schema": {
+          "type": "array",
+          "maxItems": 50,
+          "items": {
+            "type": "string"
+          },
+          "example": "token_id[]=1,token_id[]=2"
+        }
+      },
       "fine-grained-personal-access-token-id": {
         "name": "pat_id",
         "description": "The unique identifier of the fine-grained personal access token.",