1
0
mirror of synced 2026-01-06 15:01:04 -05:00
Files
docs/content/actions/managing-workflow-runs/removing-workflow-artifacts.md
2023-05-17 19:25:04 +00:00

2.6 KiB

title, intro, versions, shortTitle
title intro versions shortTitle
Removing workflow artifacts You can reclaim used {% data variables.product.prodname_actions %} storage by deleting artifacts before they expire on {% data variables.product.product_name %}.
fpt ghes ghae ghec
* * * *
Remove workflow artifacts

{% data reusables.actions.enterprise-github-hosted-runners %}

Deleting an artifact

{% warning %}

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

{% endwarning %}

{% data reusables.repositories.permissions-statement-write %}

{% data reusables.actions.artifact-log-retention-statement %}

{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.actions-tab %} {% data reusables.repositories.navigate-to-workflow %} {% data reusables.repositories.view-run %}

  1. Under Artifacts, click {% octicon "trash" aria-label="Remove artifact ARTIFACT-NAME" %} 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 {% ifversion fpt or ghec or ghes %}"AUTOTITLE."{% elsif ghae %}"AUTOTITLE," "AUTOTITLE," or "AUTOTITLE."{% endif %}

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

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