Skip to main content
GitHub AE is currently under limited release.
All products
GitHub Actions

Removing workflow artifacts

In this article

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

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 AE stores build logs and artifacts for 90 days, and this retention period can be customized.

  1. On your enterprise, 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.

    Screenshot of the left sidebar of the "Actions" tab. A workflow, "CodeQL," is outlined in dark orange.

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

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

    Screenshot showing artifacts created during a workflow run. A trash can icon, used to remove an artifact, is outlined in dark orange.

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 "Managing GitHub Actions settings for a repository," "Configuring the retention period for GitHub Actions artifacts and logs in your organization," or "Enforcing policies for GitHub Actions in your enterprise."

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 "Actions."