diff --git a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json index 69cb6d039..995afb138 100644 --- a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json +++ b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json @@ -62164,7 +62164,7 @@ "/enterprises/{enterprise}/credentials": { "get": { "summary": "List enterprise token inventory", - "description": "Lists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", + "description": "> [!WARNING]\n> **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use \"[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)\", which accepts the same filters in its request body, to start a CSV export, then \"[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)\" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/).\n\nLists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", "tags": [ "enterprise-admin" ], @@ -62771,8 +62771,11 @@ "githubCloudOnly": true, "enabledForGitHubApps": true, "category": "enterprise-admin", - "subcategory": "token-inventory" - } + "subcategory": "token-inventory", + "deprecationDate": "2026-09-29", + "removalDate": "2026-10-02" + }, + "deprecated": true } }, "/enterprises/{enterprise}/credentials/exports": { @@ -63055,7 +63058,7 @@ "/enterprises/{enterprise}/credentials/{inventory_id}": { "get": { "summary": "Get an enterprise token inventory item", - "description": "Returns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", + "description": "> [!WARNING]\n> **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use \"[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)\" to start a CSV export, optionally scoped with filters such as `owner` or `application`, then \"[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)\" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/).\n\nReturns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", "tags": [ "enterprise-admin" ], @@ -63418,8 +63421,11 @@ "githubCloudOnly": true, "enabledForGitHubApps": true, "category": "enterprise-admin", - "subcategory": "token-inventory" - } + "subcategory": "token-inventory", + "deprecationDate": "2026-09-29", + "removalDate": "2026-10-02" + }, + "deprecated": true } }, "/enterprises/{enterprise}/dependabot/alerts": { diff --git a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml index 0b33f73a3..a72d79ae7 100644 --- a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml +++ b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml @@ -21682,6 +21682,9 @@ paths: get: summary: List enterprise token inventory description: |- + > [!WARNING] + > **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use "[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)", which accepts the same filters in its request body, to start a CSV export, then "[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/). + Lists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count. You must be an enterprise owner (or hold a role with the "View enterprise credentials" permission) to use this endpoint. @@ -22160,6 +22163,9 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: token-inventory + deprecationDate: '2026-09-29' + removalDate: '2026-10-02' + deprecated: true "/enterprises/{enterprise}/credentials/exports": post: summary: Create an enterprise token inventory export @@ -22347,6 +22353,9 @@ paths: get: summary: Get an enterprise token inventory item description: |- + > [!WARNING] + > **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use "[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)" to start a CSV export, optionally scoped with filters such as `owner` or `application`, then "[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/). + Returns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise. You must be an enterprise owner (or hold a role with the "View enterprise credentials" permission) to use this endpoint. @@ -22420,6 +22429,9 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: token-inventory + deprecationDate: '2026-09-29' + removalDate: '2026-10-02' + deprecated: true "/enterprises/{enterprise}/dependabot/alerts": get: summary: List Dependabot alerts for an enterprise diff --git a/descriptions-next/ghec/dereferenced/ghec.2026-03-10.deref.json b/descriptions-next/ghec/dereferenced/ghec.2026-03-10.deref.json index ca3730831..7f17da28b 100644 --- a/descriptions-next/ghec/dereferenced/ghec.2026-03-10.deref.json +++ b/descriptions-next/ghec/dereferenced/ghec.2026-03-10.deref.json @@ -62031,7 +62031,7 @@ "/enterprises/{enterprise}/credentials": { "get": { "summary": "List enterprise token inventory", - "description": "Lists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", + "description": "> [!WARNING]\n> **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use \"[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)\", which accepts the same filters in its request body, to start a CSV export, then \"[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)\" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/).\n\nLists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", "tags": [ "enterprise-admin" ], @@ -62638,8 +62638,11 @@ "githubCloudOnly": true, "enabledForGitHubApps": true, "category": "enterprise-admin", - "subcategory": "token-inventory" - } + "subcategory": "token-inventory", + "deprecationDate": "2026-09-29", + "removalDate": "2026-10-02" + }, + "deprecated": true } }, "/enterprises/{enterprise}/credentials/exports": { @@ -62922,7 +62925,7 @@ "/enterprises/{enterprise}/credentials/{inventory_id}": { "get": { "summary": "Get an enterprise token inventory item", - "description": "Returns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", + "description": "> [!WARNING]\n> **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use \"[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)\" to start a CSV export, optionally scoped with filters such as `owner` or `application`, then \"[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)\" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/).\n\nReturns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", "tags": [ "enterprise-admin" ], @@ -63285,8 +63288,11 @@ "githubCloudOnly": true, "enabledForGitHubApps": true, "category": "enterprise-admin", - "subcategory": "token-inventory" - } + "subcategory": "token-inventory", + "deprecationDate": "2026-09-29", + "removalDate": "2026-10-02" + }, + "deprecated": true } }, "/enterprises/{enterprise}/dependabot/alerts": { diff --git a/descriptions-next/ghec/dereferenced/ghec.2026-03-10.deref.yaml b/descriptions-next/ghec/dereferenced/ghec.2026-03-10.deref.yaml index f2c163aaa..28d7684eb 100644 --- a/descriptions-next/ghec/dereferenced/ghec.2026-03-10.deref.yaml +++ b/descriptions-next/ghec/dereferenced/ghec.2026-03-10.deref.yaml @@ -21630,6 +21630,9 @@ paths: get: summary: List enterprise token inventory description: |- + > [!WARNING] + > **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use "[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)", which accepts the same filters in its request body, to start a CSV export, then "[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/). + Lists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count. You must be an enterprise owner (or hold a role with the "View enterprise credentials" permission) to use this endpoint. @@ -22108,6 +22111,9 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: token-inventory + deprecationDate: '2026-09-29' + removalDate: '2026-10-02' + deprecated: true "/enterprises/{enterprise}/credentials/exports": post: summary: Create an enterprise token inventory export @@ -22295,6 +22301,9 @@ paths: get: summary: Get an enterprise token inventory item description: |- + > [!WARNING] + > **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use "[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)" to start a CSV export, optionally scoped with filters such as `owner` or `application`, then "[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/). + Returns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise. You must be an enterprise owner (or hold a role with the "View enterprise credentials" permission) to use this endpoint. @@ -22368,6 +22377,9 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: token-inventory + deprecationDate: '2026-09-29' + removalDate: '2026-10-02' + deprecated: true "/enterprises/{enterprise}/dependabot/alerts": get: summary: List Dependabot alerts for an enterprise diff --git a/descriptions-next/ghec/dereferenced/ghec.deref.json b/descriptions-next/ghec/dereferenced/ghec.deref.json index e03d39e10..434f53486 100644 --- a/descriptions-next/ghec/dereferenced/ghec.deref.json +++ b/descriptions-next/ghec/dereferenced/ghec.deref.json @@ -62611,7 +62611,7 @@ "/enterprises/{enterprise}/credentials": { "get": { "summary": "List enterprise token inventory", - "description": "Lists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", + "description": "> [!WARNING]\n> **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use \"[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)\", which accepts the same filters in its request body, to start a CSV export, then \"[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)\" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/).\n\nLists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", "tags": [ "enterprise-admin" ], @@ -63218,8 +63218,11 @@ "githubCloudOnly": true, "enabledForGitHubApps": true, "category": "enterprise-admin", - "subcategory": "token-inventory" - } + "subcategory": "token-inventory", + "deprecationDate": "2026-09-29", + "removalDate": "2026-10-02" + }, + "deprecated": true } }, "/enterprises/{enterprise}/credentials/exports": { @@ -63502,7 +63505,7 @@ "/enterprises/{enterprise}/credentials/{inventory_id}": { "get": { "summary": "Get an enterprise token inventory item", - "description": "Returns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", + "description": "> [!WARNING]\n> **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use \"[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)\" to start a CSV export, optionally scoped with filters such as `owner` or `application`, then \"[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)\" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/).\n\nReturns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", "tags": [ "enterprise-admin" ], @@ -63865,8 +63868,11 @@ "githubCloudOnly": true, "enabledForGitHubApps": true, "category": "enterprise-admin", - "subcategory": "token-inventory" - } + "subcategory": "token-inventory", + "deprecationDate": "2026-09-29", + "removalDate": "2026-10-02" + }, + "deprecated": true } }, "/enterprises/{enterprise}/dependabot/alerts": { diff --git a/descriptions-next/ghec/dereferenced/ghec.deref.yaml b/descriptions-next/ghec/dereferenced/ghec.deref.yaml index 806060a37..ca5440651 100644 --- a/descriptions-next/ghec/dereferenced/ghec.deref.yaml +++ b/descriptions-next/ghec/dereferenced/ghec.deref.yaml @@ -21836,6 +21836,9 @@ paths: get: summary: List enterprise token inventory description: |- + > [!WARNING] + > **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use "[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)", which accepts the same filters in its request body, to start a CSV export, then "[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/). + Lists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count. You must be an enterprise owner (or hold a role with the "View enterprise credentials" permission) to use this endpoint. @@ -22314,6 +22317,9 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: token-inventory + deprecationDate: '2026-09-29' + removalDate: '2026-10-02' + deprecated: true "/enterprises/{enterprise}/credentials/exports": post: summary: Create an enterprise token inventory export @@ -22501,6 +22507,9 @@ paths: get: summary: Get an enterprise token inventory item description: |- + > [!WARNING] + > **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use "[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)" to start a CSV export, optionally scoped with filters such as `owner` or `application`, then "[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/). + Returns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise. You must be an enterprise owner (or hold a role with the "View enterprise credentials" permission) to use this endpoint. @@ -22574,6 +22583,9 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: token-inventory + deprecationDate: '2026-09-29' + removalDate: '2026-10-02' + deprecated: true "/enterprises/{enterprise}/dependabot/alerts": get: summary: List Dependabot alerts for an enterprise diff --git a/descriptions-next/ghec/ghec.2022-11-28.json b/descriptions-next/ghec/ghec.2022-11-28.json index b09e5b4a0..aa14cf19a 100644 --- a/descriptions-next/ghec/ghec.2022-11-28.json +++ b/descriptions-next/ghec/ghec.2022-11-28.json @@ -15251,7 +15251,7 @@ "/enterprises/{enterprise}/credentials": { "get": { "summary": "List enterprise token inventory", - "description": "Lists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", + "description": "> [!WARNING]\n> **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use \"[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)\", which accepts the same filters in its request body, to start a CSV export, then \"[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)\" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/).\n\nLists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", "tags": [ "enterprise-admin" ], @@ -15398,8 +15398,11 @@ "githubCloudOnly": true, "enabledForGitHubApps": true, "category": "enterprise-admin", - "subcategory": "token-inventory" - } + "subcategory": "token-inventory", + "deprecationDate": "2026-09-29", + "removalDate": "2026-10-02" + }, + "deprecated": true } }, "/enterprises/{enterprise}/credentials/exports": { @@ -15602,7 +15605,7 @@ "/enterprises/{enterprise}/credentials/{inventory_id}": { "get": { "summary": "Get an enterprise token inventory item", - "description": "Returns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", + "description": "> [!WARNING]\n> **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use \"[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)\" to start a CSV export, optionally scoped with filters such as `owner` or `application`, then \"[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)\" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/).\n\nReturns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", "tags": [ "enterprise-admin" ], @@ -15649,8 +15652,11 @@ "githubCloudOnly": true, "enabledForGitHubApps": true, "category": "enterprise-admin", - "subcategory": "token-inventory" - } + "subcategory": "token-inventory", + "deprecationDate": "2026-09-29", + "removalDate": "2026-10-02" + }, + "deprecated": true } }, "/enterprises/{enterprise}/dependabot/alerts": { diff --git a/descriptions-next/ghec/ghec.2022-11-28.yaml b/descriptions-next/ghec/ghec.2022-11-28.yaml index 0574f5e84..ace7e2504 100644 --- a/descriptions-next/ghec/ghec.2022-11-28.yaml +++ b/descriptions-next/ghec/ghec.2022-11-28.yaml @@ -11393,6 +11393,9 @@ paths: get: summary: List enterprise token inventory description: |- + > [!WARNING] + > **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use "[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)", which accepts the same filters in its request body, to start a CSV export, then "[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/). + Lists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count. You must be an enterprise owner (or hold a role with the "View enterprise credentials" permission) to use this endpoint. @@ -11513,6 +11516,9 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: token-inventory + deprecationDate: '2026-09-29' + removalDate: '2026-10-02' + deprecated: true "/enterprises/{enterprise}/credentials/exports": post: summary: Create an enterprise token inventory export @@ -11675,6 +11681,9 @@ paths: get: summary: Get an enterprise token inventory item description: |- + > [!WARNING] + > **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use "[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)" to start a CSV export, optionally scoped with filters such as `owner` or `application`, then "[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/). + Returns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise. You must be an enterprise owner (or hold a role with the "View enterprise credentials" permission) to use this endpoint. @@ -11713,6 +11722,9 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: token-inventory + deprecationDate: '2026-09-29' + removalDate: '2026-10-02' + deprecated: true "/enterprises/{enterprise}/dependabot/alerts": get: summary: List Dependabot alerts for an enterprise diff --git a/descriptions-next/ghec/ghec.2026-03-10.json b/descriptions-next/ghec/ghec.2026-03-10.json index affd9ab1e..e67ec618d 100644 --- a/descriptions-next/ghec/ghec.2026-03-10.json +++ b/descriptions-next/ghec/ghec.2026-03-10.json @@ -15251,7 +15251,7 @@ "/enterprises/{enterprise}/credentials": { "get": { "summary": "List enterprise token inventory", - "description": "Lists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", + "description": "> [!WARNING]\n> **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use \"[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)\", which accepts the same filters in its request body, to start a CSV export, then \"[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)\" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/).\n\nLists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", "tags": [ "enterprise-admin" ], @@ -15398,8 +15398,11 @@ "githubCloudOnly": true, "enabledForGitHubApps": true, "category": "enterprise-admin", - "subcategory": "token-inventory" - } + "subcategory": "token-inventory", + "deprecationDate": "2026-09-29", + "removalDate": "2026-10-02" + }, + "deprecated": true } }, "/enterprises/{enterprise}/credentials/exports": { @@ -15602,7 +15605,7 @@ "/enterprises/{enterprise}/credentials/{inventory_id}": { "get": { "summary": "Get an enterprise token inventory item", - "description": "Returns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", + "description": "> [!WARNING]\n> **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use \"[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)\" to start a CSV export, optionally scoped with filters such as `owner` or `application`, then \"[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)\" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/).\n\nReturns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", "tags": [ "enterprise-admin" ], @@ -15649,8 +15652,11 @@ "githubCloudOnly": true, "enabledForGitHubApps": true, "category": "enterprise-admin", - "subcategory": "token-inventory" - } + "subcategory": "token-inventory", + "deprecationDate": "2026-09-29", + "removalDate": "2026-10-02" + }, + "deprecated": true } }, "/enterprises/{enterprise}/dependabot/alerts": { diff --git a/descriptions-next/ghec/ghec.2026-03-10.yaml b/descriptions-next/ghec/ghec.2026-03-10.yaml index 39e6bbdb7..81f8d81fd 100644 --- a/descriptions-next/ghec/ghec.2026-03-10.yaml +++ b/descriptions-next/ghec/ghec.2026-03-10.yaml @@ -11393,6 +11393,9 @@ paths: get: summary: List enterprise token inventory description: |- + > [!WARNING] + > **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use "[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)", which accepts the same filters in its request body, to start a CSV export, then "[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/). + Lists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count. You must be an enterprise owner (or hold a role with the "View enterprise credentials" permission) to use this endpoint. @@ -11513,6 +11516,9 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: token-inventory + deprecationDate: '2026-09-29' + removalDate: '2026-10-02' + deprecated: true "/enterprises/{enterprise}/credentials/exports": post: summary: Create an enterprise token inventory export @@ -11675,6 +11681,9 @@ paths: get: summary: Get an enterprise token inventory item description: |- + > [!WARNING] + > **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use "[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)" to start a CSV export, optionally scoped with filters such as `owner` or `application`, then "[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/). + Returns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise. You must be an enterprise owner (or hold a role with the "View enterprise credentials" permission) to use this endpoint. @@ -11713,6 +11722,9 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: token-inventory + deprecationDate: '2026-09-29' + removalDate: '2026-10-02' + deprecated: true "/enterprises/{enterprise}/dependabot/alerts": get: summary: List Dependabot alerts for an enterprise diff --git a/descriptions-next/ghec/ghec.json b/descriptions-next/ghec/ghec.json index 81b106736..a46b436c8 100644 --- a/descriptions-next/ghec/ghec.json +++ b/descriptions-next/ghec/ghec.json @@ -15265,7 +15265,7 @@ "/enterprises/{enterprise}/credentials": { "get": { "summary": "List enterprise token inventory", - "description": "Lists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", + "description": "> [!WARNING]\n> **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use \"[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)\", which accepts the same filters in its request body, to start a CSV export, then \"[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)\" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/).\n\nLists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", "tags": [ "enterprise-admin" ], @@ -15412,8 +15412,11 @@ "githubCloudOnly": true, "enabledForGitHubApps": true, "category": "enterprise-admin", - "subcategory": "token-inventory" - } + "subcategory": "token-inventory", + "deprecationDate": "2026-09-29", + "removalDate": "2026-10-02" + }, + "deprecated": true } }, "/enterprises/{enterprise}/credentials/exports": { @@ -15616,7 +15619,7 @@ "/enterprises/{enterprise}/credentials/{inventory_id}": { "get": { "summary": "Get an enterprise token inventory item", - "description": "Returns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", + "description": "> [!WARNING]\n> **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use \"[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)\" to start a CSV export, optionally scoped with filters such as `owner` or `application`, then \"[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)\" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/).\n\nReturns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise.\n\nYou must be an enterprise owner (or hold a role with the \"View enterprise credentials\" permission) to use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) require the `read:enterprise` scope to access this endpoint.", "tags": [ "enterprise-admin" ], @@ -15663,8 +15666,11 @@ "githubCloudOnly": true, "enabledForGitHubApps": true, "category": "enterprise-admin", - "subcategory": "token-inventory" - } + "subcategory": "token-inventory", + "deprecationDate": "2026-09-29", + "removalDate": "2026-10-02" + }, + "deprecated": true } }, "/enterprises/{enterprise}/dependabot/alerts": { diff --git a/descriptions-next/ghec/ghec.yaml b/descriptions-next/ghec/ghec.yaml index eed417b7c..c145bb512 100644 --- a/descriptions-next/ghec/ghec.yaml +++ b/descriptions-next/ghec/ghec.yaml @@ -11401,6 +11401,9 @@ paths: get: summary: List enterprise token inventory description: |- + > [!WARNING] + > **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use "[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)", which accepts the same filters in its request body, to start a CSV export, then "[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/). + Lists an enterprise's credential inventory: both credentials currently authorized to access the enterprise and credentials owned by enterprise members that have no current enterprise authorization. Covers personal access tokens (classic and fine-grained), OAuth App and GitHub App user tokens, SSH keys, GitHub App installations, and federated credentials, assembled on demand from the canonical sources. Results are paginated with an opaque cursor via the `Link` header; there is no total count. You must be an enterprise owner (or hold a role with the "View enterprise credentials" permission) to use this endpoint. @@ -11521,6 +11524,9 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: token-inventory + deprecationDate: '2026-09-29' + removalDate: '2026-10-02' + deprecated: true "/enterprises/{enterprise}/credentials/exports": post: summary: Create an enterprise token inventory export @@ -11683,6 +11689,9 @@ paths: get: summary: Get an enterprise token inventory item description: |- + > [!WARNING] + > **Closing down notice:** This operation is closing down and will be removed on October 2, 2026. Please migrate to the asynchronous export: use "[Create an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#create-an-enterprise-token-inventory-export)" to start a CSV export, optionally scoped with filters such as `owner` or `application`, then "[Get an enterprise token inventory export](https://docs.github.com/enterprise-cloud@latest/rest/enterprise-admin/token-inventory#get-an-enterprise-token-inventory-export)" to download it. For more information, see the [changelog](https://github.blog/changelog/2026-09-21-github-enterprise-adds-credential-inventory-exports/). + Returns a single credential from the enterprise token inventory. Use the opaque `inventory_id` returned by the list endpoint for the same enterprise. You must be an enterprise owner (or hold a role with the "View enterprise credentials" permission) to use this endpoint. @@ -11721,6 +11730,9 @@ paths: enabledForGitHubApps: true category: enterprise-admin subcategory: token-inventory + deprecationDate: '2026-09-29' + removalDate: '2026-10-02' + deprecated: true "/enterprises/{enterprise}/dependabot/alerts": get: summary: List Dependabot alerts for an enterprise