- uses: actions/download-artifact@v8
  with:
    # Name of the artifact to download.
    # If unspecified, all artifacts for the run are downloaded.
    # Optional.
    name:

    # IDs of the artifacts to download, comma-separated.
    # Either inputs `artifact-ids` or `name` can be used, but not both.
    # Optional.
    artifact-ids:

    # Destination path. Supports basic tilde expansion.
    # Optional. Default is $GITHUB_WORKSPACE
    path:

    # A glob pattern to the artifacts that should be downloaded.
    # Ignored if name is specified.
    # Optional.
    pattern:

    # When multiple artifacts are matched, this changes the behavior of the destination directories.
    # If true, the downloaded artifacts will be in the same directory specified by path.
    # If false, the downloaded artifacts will be extracted into individual named directories within the specified path.
    # Note: When downloading a single artifact (by name or ID), it will always be extracted directly to the specified path.
    # Optional. Default is 'false'
    merge-multiple:

    # The GitHub token used to authenticate with the GitHub API.
    # This is required when downloading artifacts from a different repository or from a different workflow run.
    # Optional. If unspecified, the action will download artifacts from the current repo and the current workflow run.
    github-token:

    # The repository owner and the repository name joined together by "/".
    # If github-token is specified, this is the repository that artifacts will be downloaded from.
    # Optional. Default is ${{ github.repository }}
    repository:

    # The id of the workflow run where the desired download artifact was uploaded from.
    # If github-token is specified, this is the run that artifacts will be downloaded from.
    # Optional. Default is ${{ github.run_id }}
    run-id:

    # Whether to skip decompressing a zip file (if detected).
    # If true, the downloaded artifact will not be automatically extracted/decompressed.
    # This is useful when you want to handle the artifact as-is without extraction.
    # Optional. Default is `false`
    skip-decompress:

    # What to do if the action detects a mismatch between the downloaded hash and the expected hash from the server.
    # Can be one of: `ignore`, `info`, `warn`, `error`
    # Optional. Default is `error`
    digest-mismatch:

steps:
- uses: actions/download-artifact@v8
  with:
    name: my-artifact
- name: Display structure of downloaded files
  run: ls -R

steps:
- uses: actions/download-artifact@v8
  with:
    name: my-artifact
    path: your/destination/dir
- name: Display structure of downloaded files
  run: ls -R your/destination/dir

steps:
- uses: actions/download-artifact@v8
  with:
    name: my-artifact.json # corresponds to the uploaded file name

steps:
- uses: actions/download-artifact@v8
  with:
    artifact-ids: 12345
- name: Display structure of downloaded files
  run: ls -R

steps:
- uses: actions/download-artifact@v8
  with:
    artifact-ids: 12345
    path: your/destination/dir
- name: Display structure of downloaded files
  run: ls -R your/destination/dir

steps:
- uses: actions/download-artifact@v8
  with:
    artifact-ids: 12345,67890
    path: path/to/artifacts
- name: Display structure of downloaded files
  run: ls -R path/to/artifacts

steps:
- uses: actions/download-artifact@v8
- name: Display structure of downloaded files
  run: ls -R

steps:
- uses: actions/download-artifact@v8
  with:
    path: path/to/artifacts
- name: Display structure of downloaded files
  run: ls -R path/to/artifacts

steps:
- uses: actions/download-artifact@v8
  with:
    path: path/to/artifacts
    merge-multiple: true
- name: Display structure of downloaded files
  run: ls -R path/to/artifacts

jobs:
  upload:
    strategy:
      matrix:
        runs-on: [ubuntu-latest, macos-latest, windows-latest]
    runs-on: ${{ matrix.runs-on }}
    steps:
    - name: Create a File
      run: echo "hello from ${{ matrix.runs-on }}" > file-${{ matrix.runs-on }}.txt
    - name: Upload Artifact
      uses: actions/upload-artifact@v7
      with:
        name: my-artifact-${{ matrix.runs-on }}
        path: file-${{ matrix.runs-on }}.txt
  download:
    needs: upload
    runs-on: ubuntu-latest
    steps:
    - name: Download All Artifacts
      uses: actions/download-artifact@v8
      with:
        path: my-artifact
        pattern: my-artifact-*
        merge-multiple: true
    - run: ls -R my-artifact

steps:
- uses: actions/download-artifact@v8
  with:
    name: my-other-artifact
    github-token: ${{ secrets.GH_PAT }} # token with actions:read permissions on target repo
    repository: actions/toolkit
    run-id: 1234

- name: 'Tar files'
  run: tar -cvf my_files.tar /path/to/my/directory

- name: 'Upload Artifact'
  uses: actions/upload-artifact@v7
  with:
    path: my_files.tar
    archive: false

----

# Later, download the file by name

- name: 'Download Artifact'
  uses: actions/download-artifact@v8
  with:
    name: my_files.tar