pytooling/📤 Upload Artifact (Preserve File Permissions)

Tarball files before uploading the artifact to preserve file privileges.

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Activelast commit Jun 20, 2026
License: MIT

Pinned Snippet

workflow.ymlSHA-pinned

uses: pytooling/upload-artifact@703449baa2b69f4712de3fda628f3565f128096d # v1.11.0

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
name	Name of the artifact to upload.	no	artifact
working-directory	—	no	""
path	A file, directory or wildcard pattern that describes what to upload.	yes	—
if-no-files-found	The desired behavior if no files are found using the provided path. Available Options: warn: Output a warning but do not fail the action error: Fail the action with an error message ignore: Do not output any warnings or errors, the action does not fail	no	warn
retention-days	Duration after which artifact will expire in days. 0 means using default retention. Minimum 1 day. Maximum 90 days unless changed from the repository settings page. Defaults to repository settings.	no	—
compression-level	The level of compression for Zlib to be applied to the artifact archive. The value can range from 0 to 9. For large files that are not easily compressed, a value of 0 is recommended for significantly faster uploads.	no	6
overwrite	If true, an artifact with a matching name will be deleted before a new one is uploaded. If false, the action will fail if an artifact for the given name already exists. Does not fail if the artifact does not exist.	no	false
include-hidden-files	Whether to include hidden files in the provided path in the artifact The file contents of any hidden files in the path should be validated before enabled this to avoid uploading sensitive information.	no	false
mode	Mode of operation. Allowed modes: tar (default), legacy	no	tar
investigate	If enabled, list content of the created tarball.	no	false
tarball-name	Filename of the embedded tarball.	no	__pyTooling_upload_artifact__.tar

Outputs

name	description
artifact-id	GitHub ID of an Artifact, can be used by the REST API.
artifact-url	URL to download an Artifact. Can be used in many scenarios such as linking to artifacts in issues or pull requests. Users must be logged-in in order for this URL to work. This URL is valid as long as the artifact has not expired or the artifact, run or repository have not been deleted.