| | --- |
| | title: REST API endpoints for packages |
| | shortTitle: Packages |
| | allowTitleToDifferFromFilename: true |
| | intro: 'Use the REST API to interact with {% data variables.product.prodname_registry %}.' |
| | versions: |
| | fpt: '*' |
| | ghec: '*' |
| | ghes: '*' |
| | topics: |
| | - API |
| | redirect_from: |
| | - /rest/reference/packages |
| | autogenerated: rest |
| | --- |
| | |
| | ## About {% data variables.product.prodname_registry %} |
| | |
| | {% data variables.product.prodname_registry %} supports a range of package managers for publishing packages. For more information, see [AUTOTITLE](/packages/learn-github-packages/introduction-to-github-packages#supported-clients-and-formats). |
| |
|
| | After you publish a package, you can use the REST API to manage the package in your {% data variables.product.prodname_dotcom %} repositories and organizations. For more information, see [AUTOTITLE](/packages/learn-github-packages/deleting-and-restoring-a-package). |
| | |
| | To use the REST API to manage {% data variables.product.prodname_registry %}, you must authenticate using a {% data variables.product.pat_v1 %}. |
| | * To access package metadata, your token must include the `read:packages` scope. |
| | * To delete packages and package versions, your token must include the `read:packages` and `delete:packages` scopes. |
| | * To restore packages and package versions, your token must include the `read:packages` and `write:packages` scopes. |
| | |
| | If your package is in a registry that supports granular permissions, then your token does not need the `repo` scope to access or manage this package. If your package is in a registry that only supports repository-scoped permissions, then your token must also include the `repo` scope since your package inherits permissions from a {% data variables.product.prodname_dotcom %} repository. For a list of registries that only support repository-scoped permissions, see [AUTOTITLE](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages). |
| |
|
| | {% ifversion ghec %} |
| | To access resources in an organization with SSO enabled, you must enable SSO for your {% data variables.product.pat_v1 %}. For more information, see [AUTOTITLE](/authentication/authenticating-with-saml-single-sign-on/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on). |
| | {% endif %} |
| | |
| | <!-- Content after this section is automatically generated --> |
| | |
