# /api/v3/file_links/{id}/download
---
get:
  summary: Creates a download uri of the linked file.
  operationId: download_file_link
  tags:
    - File links
  description: |-
    Creates a uri to download the origin file linked by the given file link. This uri depends on the storage type and
    is always located on the origin storage itself.
  parameters:
    - name: id
      description: File link id
      in: path
      required: true
      schema:
        type: integer
      example: 42
  responses:
    '303':
      headers:
        Location:
          schema:
            type: string
            format: uri
      description: |-
        Returned if the request was successful. In the `Location` header is the uri where the client can download the
        origin file from the storage.
    '404':
      content:
        application/hal+json:
          schema:
            $ref: '../components/schemas/error_response.yml'
          example:
            _type: Error
            errorIdentifier: urn:openproject-org:api:v3:errors:NotFound
            message: The requested resource could not be found.
      description: |-
        Returned if the work package does not exist or the client does not have sufficient permissions to see it.

        **Required permission:** view work package, view file links
