Skip to main content

This version of GitHub Enterprise was discontinued on 2023-01-18. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Removing workflow artifacts

You can reclaim used GitHub Actions storage by deleting artifacts before they expire on GitHub Enterprise Server.

Note: GitHub-hosted runners are not currently supported on GitHub Enterprise Server. You can see more information about planned future support on the GitHub public roadmap.

Deleting an artifact

Warning: Once you delete an artifact, it cannot be restored.

Write access to the repository is required to perform these steps.

By default, GitHub Enterprise Server stores build logs and artifacts for 90 days, and this retention period can be customized. For more information, see "Usage limits, billing, and administration."

  1. On your GitHub Enterprise Server instance, navigate to the main page of the repository.

  2. Under your repository name, click Actions. Actions tab in the main repository navigation

  3. In the left sidebar, click the workflow you want to see. Workflow list in left sidebar

  4. From the list of workflow runs, click the name of the run to see the workflow run summary.

    Name of workflow run

  5. Under Artifacts, click next to the artifact you want to remove.

    Delete artifact drop-down menu

Setting the retention period for an artifact

Retention periods for artifacts and logs can be configured at the repository, organization, and enterprise level. For more information, see "Usage limits, billing, and administration."

You can also define a custom retention period for individual artifacts using the actions/upload-artifact action in a workflow. For more information, see "Storing workflow data as artifacts."

Finding the expiration date of an artifact

You can use the API to confirm the date that an artifact is scheduled to be deleted. For more information, see the expires_at value returned by "List artifacts for a repository."